github

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

type Comment struct {
	Author    string
	Body      string
	CreatedAt time.Time
	URL       string
}

type Commit struct {
	SHA           string
	AuthorLogin   string
	AuthorName    string
	AuthorEmail   string
	AuthoredDate  time.Time
	CommitterDate time.Time
	Message       string
	URL           string
}

type CommitList struct {
	Items []Commit
}

type FileChange struct {
	Path           string
	Status         string // "added" | "modified" | "removed" | "renamed"
	Additions      int
	Deletions      int
	Patch          string
	PatchTruncated bool // true when Patch was truncated to fit the size cap
}

type FileContent struct {
	Path      string
	Ref       string // resolved commit SHA
	Size      int64
	Content   string // empty when IsBinary is true
	Truncated bool   // true when the content was truncated to fit the size cap
	IsBinary  bool
}

type Issue struct {
	Number    int
	Title     string
	Body      string
	Author    string
	State     string
	URL       string
	Labels    []string
	CreatedAt time.Time
	UpdatedAt time.Time
	ClosedAt  *time.Time // nil when the issue is still open
	Comments  []Comment
}

type IssueWithComments struct {
	Number    int
	Title     string
	Body      string
	Author    string
	State     string
	URL       string
	IsPR      bool
	CreatedAt time.Time
	Comments  []Comment
	// Since marks the boundary; comments at or after this timestamp are NEW.
	Since time.Time
}

type ListCommitsOptions struct {
	Owner   string
	Repo    string
	Ref     string    // branch / tag / SHA; empty means default branch
	Path    string    // limit to commits touching this path; empty for any
	Author  string    // GitHub login or email; empty for any
	Since   time.Time // zero value means no lower bound
	Until   time.Time // zero value means no upper bound
	PerPage int       // 1..50; 0 defaults to 20
}

type PullRequest struct {
	Number    int
	Title     string
	Body      string
	Author    string
	State     string
	URL       string
	Labels    []string
	CreatedAt time.Time
	Comments  []Comment
	Reviews   []Review
}

type PullRequestDetail struct {
	PullRequest
	Merged    bool
	Draft     bool
	BaseRef   string
	HeadRef   string
	UpdatedAt time.Time
	ClosedAt  *time.Time // nil when the PR is still open
	// Files is non-nil only when GetPullRequestDetail was called with
	// includeFiles=true.
	Files []FileChange
}

type RepositoryValidation struct {
	Valid                bool
	Owner                string
	Repo                 string
	FullName             string
	Description          string
	IsPrivate            bool
	PullRequestCount     int
	IssueCount           int
	CanFetchPullRequests bool
	CanFetchIssues       bool
	ErrorMessage         string
}

type Review struct {
	Author    string
	Body      string
	State     string
	CreatedAt time.Time
}

type SearchHit struct {
	Number    int
	Title     string
	URL       string
	Author    string
	State     string
	CreatedAt time.Time
	Labels    []string
	IsPR      bool
	RepoOwner string
	RepoName  string
}

type SearchOptions struct {
	// Query is the GitHub search query. Supports all GitHub search operators
	// (repo:, is:open, author:, label:, etc).
	Query string
	// Type narrows results: "issue", "pr", or "" / "both" for no narrowing.
	// When set, the corresponding "is:issue" / "is:pr" qualifier is appended
	// to Query if not already present.
	Type string
	// PerPage is the page size, clamped to [1, 50]. Zero defaults to 20.
	PerPage int
}

type SearchResult struct {
	Total int
	Items []SearchHit
}