pixiv

type Account struct {
	UserID                 int64      `json:"user_id"`
	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"`
}

type AccountsResult struct {
	DefaultUserID int64     `json:"default_user_id,omitempty"`
	Accounts      []Account `json:"accounts"`
}

type AddBookmarkRequest struct {
	IllustID int64    `json:"illust_id"`
	Restrict Restrict `json:"restrict,omitempty"`
	Tags     []string `json:"tags,omitempty"`
}

type AuthExportBundle struct {
	Schema        string                    `json:"schema"`
	Version       int                       `json:"version"`
	DefaultUserID int64                     `json:"default_user_id"`
	Accounts      []AuthExportSecretAccount `json:"accounts"`
}

type AuthExportSecretAccount struct {
	UserID       int64  `json:"user_id"`
	Username     string `json:"username"`
	RefreshToken string `json:"refresh_token"`
}

type AuthExportSelection struct {
	UserID int64
	All    bool
}

type AuthRestoreResult struct {
	DefaultUserID int64     `json:"default_user_id"`
	Added         []Account `json:"added"`
	Updated       []Account `json:"updated"`
}

type Backend string

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

type ConfigValue struct {
	Key      string `json:"key"`
	Value    string `json:"value,omitempty"`
	Source   string `json:"source"`
	HasValue bool   `json:"has_value"`
}

type Cursor string

type DownloadOptions struct {
	Pages   []int
	Quality DownloadQuality
}

type DownloadQuality string

type Error struct {
	Code                    ErrorCode
	Operation               Operation
	Backend                 Backend
	Retryable               bool
	UpstreamStatus          int
	IllustID                int64
	UserID                  int64
	TransportKind           TransportKind
	LocalStateKind          LocalStateKind
	LocalWriteCommitOutcome LocalWriteCommitOutcome
	// contains filtered or unexported fields
}

type ErrorCode string

type FollowUserRequest struct {
	UserID   int64    `json:"user_id"`
	Restrict Restrict `json:"restrict,omitempty"`
}

type FollowingIllustsRequest struct {
	Restrict Restrict `json:"restrict,omitempty"`
	Cursor   Cursor   `json:"cursor,omitempty"`
}

type Illust struct {
	URL            string     `json:"url"`
	ID             int64      `json:"id"`
	Title          string     `json:"title"`
	Caption        string     `json:"caption,omitempty"`
	Type           string     `json:"type"`
	PageCount      int        `json:"page_count"`
	TotalBookmarks int        `json:"total_bookmarks"`
	TotalView      int        `json:"total_view"`
	XRestrict      int        `json:"x_restrict"`
	User           User       `json:"user"`
	Tags           []Tag      `json:"tags"`
	ImageURLs      ImageURLs  `json:"image_urls"`
	MetaSinglePage SinglePage `json:"meta_single_page"`
	MetaPages      []MetaPage `json:"meta_pages"`
	AIType         int        `json:"ai_type"`
	CreateDate     string     `json:"create_date"`
	Width          int        `json:"width"`
	Height         int        `json:"height"`
	Tools          []string   `json:"tools"`
}

type IllustDetail struct {
	Illust Illust `json:"illust"`
}

type IllustListResult struct {
	Illusts    []Illust `json:"illusts"`
	NextCursor Cursor   `json:"next_cursor,omitempty"`
}

type IllustRankingRequest struct {
	Mode   RankingMode `json:"mode,omitempty"`
	Date   string      `json:"date,omitempty"`
	Cursor Cursor      `json:"cursor,omitempty"`
}

type IllustRecommendedRequest struct {
	Cursor Cursor `json:"cursor,omitempty"`
}

type IllustRelatedRequest struct {
	IllustID int64  `json:"illust_id"`
	Cursor   Cursor `json:"cursor,omitempty"`
}

type IllustType string

type ImageURLs struct {
	SquareMedium string `json:"square_medium"`
	Medium       string `json:"medium"`
	Large        string `json:"large"`
	Original     string `json:"original"`
}

type LocalStateKind string

type LocalWriteCommitOutcome string

type LoginOptions struct {
	UseAsDefault bool
}

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

type MetaPage struct {
	PageIndex int       `json:"page_index"`
	Width     int       `json:"width"`
	Height    int       `json:"height"`
	Extension string    `json:"extension"`
	ImageURLs ImageURLs `json:"image_urls"`
}

type Novel struct {
	URL            string    `json:"url"`
	ID             int64     `json:"id"`
	Title          string    `json:"title"`
	Caption        string    `json:"caption"`
	XRestrict      int       `json:"x_restrict"`
	TextLength     int       `json:"text_length"`
	IsOriginal     bool      `json:"is_original"`
	User           User      `json:"user"`
	Tags           []Tag     `json:"tags"`
	ImageURLs      ImageURLs `json:"image_urls"`
	CreateDate     string    `json:"create_date"`
	TotalBookmarks int       `json:"total_bookmarks"`
	TotalView      int       `json:"total_view"`
}

type NovelListResult struct {
	Novels     []Novel `json:"novels"`
	NextCursor Cursor  `json:"next_cursor,omitempty"`
}

type NovelRecommendedRequest struct {
	Cursor Cursor `json:"cursor,omitempty"`
}

type NovelSearchFilters struct {
	Rating        SearchRating `json:"rating,omitempty"`
	MinTextLength int          `json:"min_text_length,omitempty"`
	MaxTextLength int          `json:"max_text_length,omitempty"`
	OriginalOnly  bool         `json:"original_only,omitempty"`
}

type OpenResourceRequest struct {
	Ref             ResourceRef
	Range           string
	IfNoneMatch     string
	IfModifiedSince string
}

type Operation string

type Options struct {
	// Logger 接收调用方显式注入的诊断 logger；为空时 SDK 严格静默，绝不使用 slog.Default。
	Logger *slog.Logger
	// HTTPClient 同时承载 App、Web、OAuth 与资源请求；为空时 SDK 创建一个
	// 无整请求固定超时的专用 client，请求生命周期由 context 控制。
	HTTPClient *http.Client
	// AppAPIBaseURL 覆盖 App API 地址，主要用于代理与测试。
	AppAPIBaseURL string
	// WebAPIBaseURL 覆盖 Pixiv Web 地址，主要用于页面补全与测试。
	WebAPIBaseURL string
	// AccessToken 是调用 App API 使用的 bearer token。
	AccessToken string
	// RefreshToken 仅供 OpenDefault 的本次快照显式选择；NewClient 不读取它。
	RefreshToken string
	// UserID 仅供 OpenDefault 从本地 auth store 选择账号。
	UserID int64
	// OAuthBaseURL 覆盖 OAuth token endpoint，主要用于测试。
	OAuthBaseURL string
	// AuthFilePath 和 ConfigFilePath 指定本地状态路径。NewClient 不会读取它们；
	// OpenDefault 在为空时使用现有默认路径。
	AuthFilePath   string
	ConfigFilePath string
	// WebFallbackEnabled 允许无 access token 时显式使用匿名 Web API。
	WebFallbackEnabled bool
	// ResourcePolicy 追加调用方显式信任的资源镜像；Pixiv 官方资源规则始终启用。
	ResourcePolicy ResourcePolicy
}

type PremiumStatus struct {
	IsPremium bool      `json:"is_premium"`
	CheckedAt time.Time `json:"checked_at"`
}

type Profile struct {
	Webpage                    *string `json:"webpage,omitempty"`
	Gender                     string  `json:"gender"`
	Birth                      string  `json:"birth"`
	BirthDay                   string  `json:"birth_day"`
	BirthYear                  int     `json:"birth_year"`
	Region                     string  `json:"region"`
	AddressID                  int64   `json:"address_id"`
	CountryCode                string  `json:"country_code"`
	Job                        string  `json:"job"`
	JobID                      int64   `json:"job_id"`
	TotalFollowUsers           int     `json:"total_follow_users"`
	TotalMyPixivUsers          int     `json:"total_mypixiv_users"`
	TotalIllusts               int     `json:"total_illusts"`
	TotalManga                 int     `json:"total_manga"`
	TotalNovels                int     `json:"total_novels"`
	TotalIllustBookmarksPublic int     `json:"total_illust_bookmarks_public"`
	TotalIllustSeries          int     `json:"total_illust_series"`
	TotalNovelSeries           int     `json:"total_novel_series"`
	BackgroundImageURL         *string `json:"background_image_url,omitempty"`
	TwitterAccount             string  `json:"twitter_account"`
	TwitterURL                 *string `json:"twitter_url,omitempty"`
	PawooURL                   *string `json:"pawoo_url,omitempty"`
	IsPremium                  bool    `json:"is_premium"`
	IsUsingCustomProfileImage  bool    `json:"is_using_custom_profile_image"`
}

type ProfileImageURLs struct {
	Medium *string `json:"medium,omitempty"`
}

type ProfilePublicity struct {
	Gender    bool `json:"gender"`
	Region    bool `json:"region"`
	BirthDay  bool `json:"birth_day"`
	BirthYear bool `json:"birth_year"`
	Job       bool `json:"job"`
	Pawoo     bool `json:"pawoo"`
}

type RankingMode string

type RecommendedUserPreview struct {
	User    User     `json:"user"`
	Illusts []Illust `json:"illusts"`
	Novels  []Novel  `json:"novels"`
}

type Reference struct {
	Kind ReferenceKind
	ID   int64
}

type ReferenceKind string

type RemoveBookmarkRequest struct {
	IllustID int64 `json:"illust_id"`
}

type ResourceMirrorPolicy struct {
	Host         string   `json:"host"`
	PathPrefixes []string `json:"path_prefixes"`
}

type ResourcePolicy struct {
	Mirrors []ResourceMirrorPolicy `json:"mirrors,omitempty"`
}

type ResourceRef struct {
	URL string `json:"url"`
}

type ResourceResponse struct {
	StatusCode int
	Header     http.Header
	Body       io.ReadCloser
}

type Restrict string

type SearchAIMode string

type SearchAspectRatio string

type SearchContentType string

type SearchIllustFilters struct {
	Rating      SearchRating      `json:"rating,omitempty"`
	ContentType SearchContentType `json:"content_type,omitempty"`
	AIMode      SearchAIMode      `json:"ai_mode,omitempty"`
	AspectRatio SearchAspectRatio `json:"aspect_ratio,omitempty"`
	Resolution  SearchResolution  `json:"resolution,omitempty"`
	Tool        string            `json:"tool,omitempty"`
	BookmarkMin *int              `json:"bookmark_min,omitempty"`
	BookmarkMax *int              `json:"bookmark_max,omitempty"`
}

type SearchIllustOptionsRequest struct {
	Word string `json:"word"`
}

type SearchIllustOptionsResult struct {
	Tools []string `json:"tools"`
}

type SearchIllustRequest struct {
	Word      string              `json:"word"`
	Target    SearchTarget        `json:"search_target,omitempty"`
	Sort      SortMode            `json:"sort,omitempty"`
	Duration  string              `json:"duration,omitempty"`
	StartDate string              `json:"start_date,omitempty"`
	EndDate   string              `json:"end_date,omitempty"`
	Cursor    Cursor              `json:"cursor,omitempty"`
	Filters   SearchIllustFilters `json:"filters,omitempty"`
}

type SearchNovelRequest struct {
	Word     string             `json:"word"`
	Target   SearchTarget       `json:"search_target,omitempty"`
	Sort     SortMode           `json:"sort,omitempty"`
	Duration string             `json:"duration,omitempty"`
	Cursor   Cursor             `json:"cursor,omitempty"`
	Filters  NovelSearchFilters `json:"filters,omitempty"`
}

type SearchRating string

type SearchResolution string

type SearchTarget string

type SearchUserRequest struct {
	Word   string `json:"word"`
	Cursor Cursor `json:"cursor,omitempty"`
}

type SinglePage struct {
	OriginalImageURL string `json:"original_image_url"`
}

type SortMode string

type Tag struct {
	Name           string `json:"name"`
	TranslatedName string `json:"translated_name"`
}

type TransportKind string

type TrendTag struct {
	Tag            string `json:"tag"`
	TranslatedName string `json:"translated_name"`
	Illust         Illust `json:"illust"`
}

type TrendingTagsIllustResult struct {
	TrendTags []TrendTag `json:"trend_tags"`
}

type UgoiraFrame struct {
	File  string `json:"file"`
	Delay int    `json:"delay"`
}

type UgoiraMetadata struct {
	ZipURLs         UgoiraZipURLs    `json:"zip_urls"`
	Frames          []UgoiraFrame    `json:"frames"`
	DownloadURL     string           `json:"download_url"`
	DownloadQuality UgoiraZipQuality `json:"download_quality"`
}

type UgoiraMetadataResult struct {
	UgoiraMetadata UgoiraMetadata `json:"ugoira_metadata"`
}

type UgoiraZipQuality string

type UgoiraZipURLs struct {
	Medium   string `json:"medium"`
	Original string `json:"original,omitempty"`
}

type UnfollowUserRequest struct {
	UserID int64 `json:"user_id"`
}

type User struct {
	ID               int64            `json:"id"`
	Name             string           `json:"name"`
	Account          string           `json:"account"`
	Comment          string           `json:"comment"`
	IsFollowed       bool             `json:"is_followed"`
	ProfileImageURLs ProfileImageURLs `json:"profile_image_urls"`
}

type UserArtworksRequest struct {
	UserID int64      `json:"user_id"`
	Type   IllustType `json:"type,omitempty"`
	Cursor Cursor     `json:"cursor,omitempty"`
}

type UserBookmarksRequest struct {
	UserID   int64    `json:"user_id"`
	Restrict Restrict `json:"restrict,omitempty"`
	Tag      string   `json:"tag,omitempty"`
	Cursor   Cursor   `json:"cursor,omitempty"`
}

type UserDetailRequest struct {
	UserID int64 `json:"user_id"`
}

type UserDetailResult struct {
	User             User             `json:"user"`
	Profile          Profile          `json:"profile"`
	ProfilePublicity ProfilePublicity `json:"profile_publicity"`
	Workspace        Workspace        `json:"workspace"`
}

type UserFollowingRequest struct {
	UserID   int64    `json:"user_id"`
	Restrict Restrict `json:"restrict,omitempty"`
	Cursor   Cursor   `json:"cursor,omitempty"`
}

type UserListResult struct {
	UserPreviews []UserPreview    `json:"user_previews"`
	NextCursor   Cursor           `json:"next_cursor,omitempty"`
	Source       UserSearchSource `json:"source,omitempty"`
}

type UserPreview struct {
	User User `json:"user"`
}

type UserRecommendedRequest struct {
	Cursor Cursor `json:"cursor,omitempty"`
}

type UserRecommendedResult struct {
	UserPreviews []RecommendedUserPreview `json:"user_previews"`
	NextCursor   Cursor                   `json:"next_cursor,omitempty"`
}

type UserSearchSource string

type Workspace struct {
	PC                string  `json:"pc"`
	Monitor           string  `json:"monitor"`
	Tool              string  `json:"tool"`
	Scanner           string  `json:"scanner"`
	Tablet            string  `json:"tablet"`
	Mouse             string  `json:"mouse"`
	Printer           string  `json:"printer"`
	Desktop           string  `json:"desktop"`
	Music             string  `json:"music"`
	Desk              string  `json:"desk"`
	Chair             string  `json:"chair"`
	Comment           string  `json:"comment"`
	WorkspaceImageURL *string `json:"workspace_image_url,omitempty"`
}