application

type AccountAddRequest struct {
	TokenInput         string
	HTTPSProxyOverride *string
}

type AccountCheckRequest struct {
	UserID             int64
	HTTPSProxyOverride *string
}

type AccountListResult struct {
	DefaultUserID int64
	Accounts      []AccountResult
}

type AccountResult struct {
	UserID   int64  `json:"user_id,omitempty"`
	Username string `json:"username,omitempty"`
	Default  bool   `json:"default"`
	HasToken bool   `json:"has_token"`
	Warning  string `json:"warning,omitempty"`
}

type AccountService struct {
	Auth            AuthRepository
	LoadRuntime     func() (config.RuntimeConfig, error)
	RefreshTokenEnv func() string
	NewClient       AuthenticatedPixivFactory
}

type ArtworkClient interface {
	SearchIllust(context.Context, string, string, string, string, int) (*pixiv.IllustList, error)
	IllustDetail(context.Context, int64) (*pixiv.IllustDetail, error)
	IllustRanking(context.Context, string, string, int) (*pixiv.IllustList, error)
	IllustRecommended(context.Context, int) (*pixiv.IllustList, error)
}

type ArtworkService struct {
	Resolver ClientResolver
}

type AuthRepository interface {
	Load() (auth.AuthStore, error)
	Save(auth.AuthStore) error
}

type AuthenticatedPixivClient interface {
	Refresh(context.Context) error
	RefreshTokenValue() string
	UserID() int64
	UserName() string
	UserDetail(context.Context, int64) (*pixiv.User, error)
}

type AuthenticatedPixivFactory func(config.RuntimeConfig) (AuthenticatedPixivClient, error)

type ClientBundle struct {
	Auth     AuthenticatedPixivClient
	Artwork  ArtworkClient
	Download DownloadClient
}

type ClientRequest struct {
	UserID                   int64
	RefreshToken             string
	HTTPSProxyOverride       *string
	DownloadPathOverride     *string
	FilenameTemplateOverride *string
	JSONOverride             *bool
	NeedsAuth                bool
}

type ClientResolver struct {
	Auth            AuthRepository
	LoadRuntime     func() (config.RuntimeConfig, error)
	RefreshTokenEnv func() string
	NewClient       PixivClientFactory
}

type ClientSession struct {
	Client  ClientBundle
	Config  config.RuntimeConfig
	JSONOut bool
}

type ConfigMutationResult struct {
	Alias       string
	EnvOverride string
	HasOverride bool
}

type ConfigService struct {
	Store ConfigStore
}

type ConfigStore interface {
	Path() (string, error)
	Get(string) (config.SettingValue, error)
	Set(string, string) (ConfigMutationResult, error)
	Unset(string) (ConfigMutationResult, error)
}

type DownloadClient interface {
	download.PixivClient
}

type DownloadFactory func(DownloadClient, config.RuntimeConfig) Downloader

type DownloadService struct {
	Resolver      ClientResolver
	NewDownloader DownloadFactory
}

type Downloader interface {
	Download(context.Context, []int64) ([]download.DownloadedArtwork, error)
}

type LoginCompleteRequest struct {
	Code               string
	Verifier           string
	OAuthBase          string
	UseAfterLogin      bool
	HTTPSProxyOverride *string
}

type LoginService struct {
	Auth        AuthRepository
	LoadRuntime func() (config.RuntimeConfig, error)
	NewOAuth    OAuthClientFactory
}

type LoginStart struct {
	Verifier  string
	Challenge string
	State     string
}

type OAuthClientFactory func(config.RuntimeConfig, string) (OAuthExchanger, error)

type OAuthExchanger interface {
	ExchangeAuthorizationCode(context.Context, string, string) (OAuthToken, error)
}

type OAuthToken struct {
	RefreshToken string
	UserID       int64
	Username     string
}

type PixivClientFactory func(config.RuntimeConfig) (ClientBundle, error)

type RankingRequest struct {
	Client ClientRequest
	Mode   string
	Date   string
	Offset int
}

type RecommendedRequest struct {
	Client ClientRequest
	Offset int
}

type SDKClient interface {
	CurrentUserID(context.Context) (int64, error)
	SearchIllust(context.Context, sdk.SearchIllustRequest) (*sdk.IllustListResult, error)
	IllustDetail(context.Context, int64) (*sdk.IllustDetail, error)
	IllustRanking(context.Context, sdk.IllustRankingRequest) (*sdk.IllustListResult, error)
	IllustRecommended(context.Context, sdk.IllustRecommendedRequest) (*sdk.IllustListResult, error)
	UserArtworks(context.Context, sdk.UserArtworksRequest) (*sdk.IllustListResult, error)
	UserBookmarks(context.Context, sdk.UserBookmarksRequest) (*sdk.IllustListResult, error)
	UserFollowing(context.Context, sdk.UserFollowingRequest) (*sdk.UserListResult, error)
	AddBookmark(context.Context, sdk.AddBookmarkRequest) error
	RemoveBookmark(context.Context, sdk.RemoveBookmarkRequest) error
	FollowUser(context.Context, sdk.FollowUserRequest) error
	UnfollowUser(context.Context, sdk.UnfollowUserRequest) error
}

type SDKClientFactory func(SDKClientRequest) (SDKClient, error)

type SDKClientRequest struct {
	UserID             int64
	RefreshToken       string
	HTTPSProxyOverride *string
	// AuthFilePath 允许 MCP 等长驻调用方把 OAuth rotation 固定到同一个受保护 store。
	// 为空时继续使用 OpenDefault 的标准路径。
	AuthFilePath string
}

type SDKService struct {
	NewClient   SDKClientFactory
	LoadRuntime func() (config.RuntimeConfig, error)
}

type SearchRequest struct {
	Client   ClientRequest
	Word     string
	Target   string
	Sort     string
	Duration string
	Offset   int
}

type Services struct {
	Account  AccountService
	Config   ConfigService
	Artwork  ArtworkService
	Download DownloadService
	Login    LoginService
	SDK      SDKService
}