github

type AuthoredPullRequest struct {
	Number    int
	Draft     bool
	State     string
	CreatedAt time.Time
	MergedAt  *time.Time
	// FirstReviewAt is the earliest submitted review by someone other than
	// the author, among the first twenty reviews; nil when there is none.
	FirstReviewAt *time.Time
	// Conflict is GitHub reporting an open pull request as conflicting now.
	Conflict bool
	// ChecksFailing is the head commit's combined check state being a failure
	// or an error now.
	ChecksFailing bool
}

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

type Clone interface {
	// RemoteFetchURL is the URL git fetches the named remote from, with
	// insteadOf rewrites applied; "" when there is no such remote.
	RemoteFetchURL(ctx context.Context, remote string) (string, error)
	// CurrentBranch is the branch HEAD is on, "" when detached.
	CurrentBranch(ctx context.Context) (string, error)
	// BranchUpstream is the branch's branch.<name>.remote and
	// branch.<name>.merge, each "" when unset.
	BranchUpstream(ctx context.Context, branch string) (remote, merge string, err error)
}

type Evidence struct {
	// Host is the GitHub host the evidence was read from.
	Host string
	// Repository is "owner/name" as GitHub spells it.
	Repository   string
	PullRequest  bundle.PullRequest
	Checks       []bundle.Check
	Conversation []bundle.ConversationItem
	Threads      []bundle.Thread
	// Images are the images GitHub rendered from the description, for the
	// attachment step to download. Their FetchURL is signed: it is never
	// stored or logged.
	Images  []bundle.RenderedImage
	Sources bundle.Sources
	// Unavailable says why each part recorded false in Sources could not be
	// read.
	Unavailable map[string]error
}

type FetchOptions struct {
	// MetadataOnly reads the PR header and current checks without fetching
	// conversations, review threads, commit lists or protection rules.
	MetadataOnly bool

	// ChecksHead reads checks for this reviewed commit, while PR metadata stays current.
	// Empty uses the current pull request head.
	ChecksHead string

	// BotReportMarkers are the bot-report markers of the base branch's
	// REVIEW.md marker registry. The registry is not built yet, so callers
	// pass none.
	BotReportMarkers []string
}

type ListedPull struct {
	Number int
	Title  string
	Body   string
	// State is "open" or "closed".
	State string
	Draft bool
	// Author is the opener's login; Bot is set when GitHub reports the
	// account as a bot.
	Author           string
	Bot              bool
	HeadRef, HeadSHA string
	BaseRef, BaseSHA string
	// CrossRepository is set when the head is in another repository than
	// the base (a fork's, or one deleted since).
	CrossRepository bool
	// DefaultBranch is the base repository's default branch.
	DefaultBranch        string
	MergeCommitSHA       string
	CreatedAt, UpdatedAt time.Time
	MergedAt, ClosedAt   *time.Time
}

type MergeError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

type MergeOptions struct {
	// Methods lists the allowed merge methods in a fixed order.
	Methods []string `json:"methods"`
	// Default is the method GitHub preselects for this user, or empty.
	Default          string `json:"default"`
	State            string `json:"state"`
	Draft            bool   `json:"draft"`
	HeadSHA          string `json:"head_sha"`
	Mergeable        string `json:"mergeable"`
	MergeStateStatus string `json:"merge_state_status"`
	// contains filtered or unexported fields
}

type Options struct {
	// Transport carries the requests; nil uses http.DefaultTransport.
	Transport       http.RoundTripper
	AuthResult      func(host, token string, status int, headers http.Header)
	AccountIdentity func(host, token string) string
}

type PullList struct {
	// Pulls are the pull requests updated at or after the cursor, most
	// recently updated first.
	Pulls []ListedPull
	// ETag is the first page's, for the next call.
	ETag string
	// NotModified is set when the first page is unchanged since ETag.
	NotModified bool
	// Calls counts the requests made.
	Calls int
	// Truncated is set when the listing stopped at its bound with older pull
	// requests still updated at or after since unlisted.
	Truncated bool
}

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

type RateLimitedError struct {
	ResumeAt time.Time
	Err      error
}

type Reader interface {
	Read(ctx context.Context, path, etag string) (int, http.Header, []byte, error)
}

type Repository struct {
	Host, Owner, Name string
}

type ResolveOptions struct {
	Repo string
	PR   int
}

type ReviewComment struct {
	Path      string `json:"path"`
	Line      int    `json:"line"`
	Side      string `json:"side"`
	StartLine int    `json:"start_line,omitempty"`
	StartSide string `json:"start_side,omitempty"`
	Body      string `json:"body"`
}

type ReviewError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

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

type ReviewSubmission struct {
	CommitID string          `json:"commit_id"`
	Body     string          `json:"body,omitempty"`
	Event    string          `json:"event"`
	Comments []ReviewComment `json:"comments,omitempty"`
}

type ReviewThread struct {
	// ID is the thread's GraphQL node id, which baum alone uses.
	ID   string
	Path string
	// Line is the thread's line, or its original line once outdated; 0 for
	// a comment on the whole file.
	Line     int
	Outdated bool
	// CanReply and CanResolve are the signed-in account's.
	CanReply, CanResolve bool
	// URL is the thread's first submitted comment on GitHub.
	URL string
	// Comments are the first ReadThreadComments submitted comments; Total
	// counts them all.
	Comments []ThreadComment
	Total    int
}

type ReviewThreads struct {
	HeadSHA string
	// ViewerDidAuthor: the signed-in account opened the pull request.
	ViewerDidAuthor bool
	// Unresolved are the unresolved threads in GitHub's order.
	Unresolved []ReviewThread
	// Capped: the pull request has more threads than baum read.
	Capped bool
}

type SearchScope struct {
	Owners       []string
	Repositories []string
}

type Target struct {
	Repository Repository
	Number     int
}

type ThreadComment struct {
	Author string
	// Association is GitHub's author association (OWNER, MEMBER,
	// COLLABORATOR, CONTRIBUTOR, NONE…); Bot marks an app's account.
	Association string
	Bot         bool
	Body        string
	// URL is the comment on GitHub; it is not part of what a fix digests.
	URL string `json:"-"`
}

type ThreadState struct {
	// Repository is "owner/name" and Number the pull request the thread is on.
	Repository string
	Number     int
	Resolved   bool
	// CanReply and CanResolve are the signed-in account's.
	CanReply, CanResolve bool
}

type TokenSource func(ctx context.Context, host string) (string, error)

type ViewerRepository struct {
	Repository  string
	Private     bool
	Fork        bool
	PushedAt    time.Time
	Description string
}

type ViewerRepositoryList struct {
	Repositories []ViewerRepository
	TotalCount   int
	NextCursor   *string
	// Scope is what the viewer may search, read with the top repositories.
	Scope SearchScope
}