application

type AccountBundleImportResult struct {
	Accounts      []AccountImportResult `json:"accounts"`
	DefaultUserID int64                 `json:"default_user_id"`
}

type AccountCheckRequest struct {
	UserID             int64
	HTTPSProxyOverride *string
}

type AccountExportRequest struct {
	UserID int64
	All    bool
}

type AccountExportResult struct {
	RefreshToken string
	Bundle       []byte
	AccountCount int
}

type AccountImportRequest struct {
	TokenInput         string
	HTTPSProxyOverride *string
}

type AccountImportResult struct {
	UserID   int64  `json:"user_id"`
	Username string `json:"username"`
	Status   string `json:"status"`
}

type AccountListResult struct {
	DefaultUserID int64
	Accounts      []AccountResult
}

type AccountPoolExecutor struct {
	Config            config.AccountPoolConfig
	State             AccountPoolStateStore
	AvailableAccounts func(context.Context) ([]int64, error)
	Now               func() time.Time
}

type AccountPoolStateStore interface {
	Lease(context.Context, []int64, []int64, config.AccountPoolStrategy, time.Time) (int64, error)
	Freeze(context.Context, int64, time.Time, time.Time) error
}

type AccountRefreshRequest struct {
	UserID             int64
	HTTPSProxyOverride *string
}

type AccountResult struct {
	UserID                 int64      `json:"user_id,omitempty"`
	Username               string     `json:"username,omitempty"`
	Default                bool       `json:"default"`
	HasToken               bool       `json:"has_token"`
	PremiumStatus          *bool      `json:"premium_status,omitempty"`
	PremiumStatusCheckedAt *time.Time `json:"premium_status_checked_at,omitempty"`
	Warning                string     `json:"warning,omitempty"`
}

type AccountService struct {
	SDK                 SDKService
	RefreshTokenFromEnv func() (string, error)
}

type AuthBundleSDKClient interface {
	ExportAuthBundle(sdk.AuthExportSelection) (*sdk.AuthExportBundle, error)
	RestoreAuthBundle(*sdk.AuthExportBundle) (*sdk.AuthRestoreResult, error)
}

type ClientRequest struct {
	UserID             int64
	RefreshToken       string
	HTTPSProxyOverride *string
	JSONOverride       *bool
	NeedsAuth          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 {
	IllustDetail(context.Context, int64) (*sdk.IllustDetail, error)
	UgoiraMetadata(context.Context, int64) (*sdk.UgoiraMetadataResult, error)
	ParseResourceRef(string) (sdk.ResourceRef, error)
	DownloadResource(context.Context, sdk.ResourceRef, string) (sdk.ResourceDownloadResult, error)
}

type DownloadFailure struct {
	URL      string
	IllustID int64
	Type     string
	Message  string
	// Cause 只用于 application/CLI 判断账号池的安全重试边界，输出 adapter
	// 只公开 Message，避免错误对象进入用户协议。
	Cause error
}

type DownloadManager interface {
	Download(context.Context, DownloadRequest) ([]DownloadedArtwork, error)
}

type DownloadManagerFactory func(client DownloadClient, downloadPath, filenameTemplate string) (DownloadManager, error)

type DownloadQuality = sdk.DownloadQuality

type DownloadReport struct {
	Items     []DownloadedArtwork
	Failures  []DownloadFailure
	Committed bool
}

type DownloadRequest struct {
	IllustIDs        []int64
	DownloadPath     string
	FilenameTemplate string
	// Pages 为 1-based 页码列表；空表示全部页。由 ParsePageSpec 生成。
	Pages []int
	// Quality 默认 original。
	Quality DownloadQuality
	// UgoiraFormat 默认 GIF，仅影响 ugoira 的最终动画容器。
	UgoiraFormat UgoiraFormat
}

type DownloadService struct {
	NewManager DownloadManagerFactory
}

type DownloadTargetClient interface {
	DownloadClient
	UserArtworks(context.Context, sdk.UserArtworksRequest) (*sdk.IllustListResult, error)
}

type DownloadedArtwork struct {
	IllustID int64
	Title    string
	Author   string
	Type     string
	Files    []DownloadedFile
}

type DownloadedFile struct {
	Path string
	Page int
}

type LoginCompleteRequest struct {
	CallbackOrCode string
	UseAfterLogin  bool
}

type LoginService struct {
	SDK         SDKService
	LoadRuntime func() (config.RuntimeConfig, error)
}

type LoginStart struct {
	AuthorizationURL string
	// contains filtered or unexported fields
}

type PagePlan struct {
	Skip     int
	Limit    int
	OneBatch bool
}

type PageResult struct {
	Returned int
	HasMore  bool
}

type Record struct {
	// contains filtered or unexported fields
}

type RecordFilter struct {
	ID           string
	Type         string
	Tags         []string
	MinViews     *int64
	MinPageCount *int64
}

type SDKClient interface {
	ImportAccount(context.Context, string) (*sdk.Account, error)
	ListAccounts() (*sdk.AccountsResult, error)
	SelectAccount(int64) error
	RemoveAccount(int64) error
	CheckAccount(context.Context, int64) (*sdk.Account, error)
	CheckRefreshToken(context.Context, string) (*sdk.Account, error)
	ExportAccountRefreshToken(int64) (string, error)
	Refresh(context.Context) (*sdk.Account, error)
	StartLogin() (*sdk.LoginSession, error)
	CompleteLogin(context.Context, *sdk.LoginSession, string, sdk.LoginOptions) (*sdk.Account, error)
	CurrentUserID(context.Context) (int64, error)
	SearchIllust(context.Context, sdk.SearchIllustRequest) (*sdk.IllustListResult, error)
	SearchNovel(context.Context, sdk.SearchNovelRequest) (*sdk.NovelListResult, error)
	SearchIllustOptions(context.Context, sdk.SearchIllustOptionsRequest) (*sdk.SearchIllustOptionsResult, error)
	IllustDetail(context.Context, int64) (*sdk.IllustDetail, error)
	IllustRelated(context.Context, sdk.IllustRelatedRequest) (*sdk.IllustListResult, error)
	IllustRanking(context.Context, sdk.IllustRankingRequest) (*sdk.IllustListResult, error)
	IllustRecommended(context.Context, sdk.IllustRecommendedRequest) (*sdk.IllustListResult, error)
	MangaRecommended(context.Context, sdk.IllustRecommendedRequest) (*sdk.IllustListResult, error)
	NovelRecommended(context.Context, sdk.NovelRecommendedRequest) (*sdk.NovelListResult, error)
	UserRecommended(context.Context, sdk.UserRecommendedRequest) (*sdk.UserRecommendedResult, error)
	UserDetail(context.Context, sdk.UserDetailRequest) (*sdk.UserDetailResult, error)
	UserArtworks(context.Context, sdk.UserArtworksRequest) (*sdk.IllustListResult, error)
	UserBookmarks(context.Context, sdk.UserBookmarksRequest) (*sdk.IllustListResult, error)
	UserBookmarksCursor(context.Context, sdk.UserBookmarksRequest, int64) (sdk.Cursor, error)
	UserFollowing(context.Context, sdk.UserFollowingRequest) (*sdk.UserListResult, error)
	FollowingIllusts(context.Context, sdk.FollowingIllustsRequest) (*sdk.IllustListResult, error)
	FollowingNovels(context.Context, sdk.FollowingNovelsRequest) (*sdk.NovelListResult, error)
	LatestIllusts(context.Context, sdk.LatestIllustsRequest) (*sdk.IllustListResult, error)
	LatestNovels(context.Context, sdk.LatestNovelsRequest) (*sdk.NovelListResult, error)
	MyPixivUsers(context.Context, sdk.MyPixivUsersRequest) (*sdk.UserListResult, error)
	MyPixivIllusts(context.Context, sdk.MyPixivIllustsRequest) (*sdk.IllustListResult, error)
	MyPixivNovels(context.Context, sdk.MyPixivNovelsRequest) (*sdk.NovelListResult, error)
	UserNovels(context.Context, sdk.UserNovelsRequest) (*sdk.NovelListResult, error)
	SearchUser(context.Context, sdk.SearchUserRequest) (*sdk.UserListResult, error)
	TrendingTagsIllust(context.Context) (*sdk.TrendingTagsIllustResult, error)
	UgoiraMetadata(context.Context, int64) (*sdk.UgoiraMetadataResult, error)
	ParseResourceRef(string) (sdk.ResourceRef, error)
	OpenResource(context.Context, sdk.OpenResourceRequest) (*sdk.ResourceResponse, error)
	DownloadResource(context.Context, sdk.ResourceRef, string) (sdk.ResourceDownloadResult, 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
	// DisableRetryAfterRetry 只供账号池首个 429 的安全切换路径使用。
	DisableRetryAfterRetry bool
	// AuthFilePath 允许 MCP 等长驻调用方把 OAuth rotation 固定到同一个受保护 store。
	// 为空时继续使用 OpenDefault 的标准路径。
	AuthFilePath string
}

type SDKPooledOperation func(context.Context, SDKClientRequest, func(context.Context, SDKClient) (committed bool, err error)) error

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

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

type UgoiraFormat = sdk.UgoiraFormat