profile

type ActivityTimeline struct {
	Username string
	From     time.Time
	To       time.Time
	Months   []MonthlyActivity
}

type CalendarDay struct {
	Date              time.Time
	Weekday           time.Weekday
	ContributionCount int
	Level             ContributionLevel // Intensity level for coloring (0-4)
}

type CalendarWeek struct {
	StartDate time.Time      // Sunday of this week
	Days      [7]CalendarDay // Sunday (0) through Saturday (6)
}

type ContributionCalendar struct {
	TotalContributions int
	Weeks              []CalendarWeek
}

type ContributionLevel int

type MonthlyActivity struct {
	Year  int
	Month time.Month

	// Contribution counts
	Commits int
	Issues  int
	PRs     int
	Reviews int

	// Commit details
	Additions int
	Deletions int

	// Repository breakdown for commits
	CommitsByRepo map[string]int // "owner/repo" -> commit count

	// Repos where user opened issues/PRs this month
	IssueRepos []string
	PRRepos    []string

	// New repos created this month
	ReposCreated []string
}

type Options struct {
	// Visibility filters which repositories to include.
	// Default is VisibilityAll.
	Visibility graphql.Visibility

	// IncludeReleases fetches release counts for each contributed repository.
	// This requires additional API calls and may be slow for users with many repos.
	IncludeReleases bool

	// MaxReleaseFetchRepos limits how many repos to fetch releases for.
	// 0 means no limit. Only used if IncludeReleases is true.
	MaxReleaseFetchRepos int

	// Progress is called to report progress during fetching.
	// If nil, no progress is reported.
	Progress ProgressFunc
}

type ProgressFunc func(info ProgressInfo)

type ProgressInfo struct {
	Stage       int    // Current stage number (1-based)
	TotalStages int    // Total number of stages
	Description string // What's happening in this stage
	Current     int    // Current item within stage (0 if not applicable)
	Total       int    // Total items in stage (0 if not applicable)
	Done        bool   // True if this stage is complete
}

type RepoCommitCount struct {
	Repo    string
	Commits int
}

type RepoContribution struct {
	Owner     string
	Name      string
	FullName  string // "owner/repo"
	IsPrivate bool
	Commits   int
	Additions int
	Deletions int
	Releases  int // Number of releases (optional, may be 0 if not fetched)
}

type UserProfile struct {
	Username string
	From     time.Time
	To       time.Time

	// Summary counts (from GitHub's contribution collection)
	// TotalCommits is the official GitHub count shown on the profile page.
	TotalCommits      int
	TotalIssues       int
	TotalPRs          int
	TotalReviews      int
	TotalReposCreated int

	// Private contributions (requires authentication as the user)
	RestrictedContributions int

	// Detailed commit stats from traversing default branch history.
	// CommitsDefaultBranch may differ from TotalCommits because it only
	// counts commits on default branches, missing feature branches,
	// squash-merged commits, and inaccessible repositories.
	CommitsDefaultBranch int
	TotalAdditions       int
	TotalDeletions       int

	// Repository data
	ReposContributedTo int
	RepoStats          []RepoContribution

	// Time-series data
	Calendar *ContributionCalendar
	Activity *ActivityTimeline
}