gh

type Client struct {
	REST *github.Client

	// AppID is the GitHub App this client authenticated as, and 0 under PAT
	// auth, where there is no app. It is the only honest answer to "which app
	// is gomgr?" — a config key or environment variable can name an app that
	// this run is not actually authenticated as — so anything resolving the
	// `app: self` bypass actor reads it from here rather than re-deriving it.
	AppID int64
	// GraphQLURL is the endpoint used by DoGraphQL. Empty means GitHub's public
	// GraphQL API. Tests may override it to point at a local server.
	GraphQLURL string
	// contains filtered or unexported fields
}

type Installation struct {
	// Org is the account's login, lowercased, because every other org name in
	// gomgr is compared lowercased. Named Org because that is what it is for
	// every installation gomgr can act on — see IsOrg for the ones it cannot.
	Org string
	// ID is the installation ID, which is what the token endpoints want.
	ID int64
	// RepositorySelection is "all" or "selected". An app installed on a
	// selected subset can be installed on the org and still be unable to see
	// the repository a config names, so the two are not the same answer.
	RepositorySelection string
	// IsOrg reports whether this installation is on an organization rather
	// than a user account.
	//
	// An app can be installed on a personal account, and gomgr can never act on
	// one: auth resolves through GetOrganizationInstallation, which answers 404
	// for a user. Such an installation is still worth reporting — it is real,
	// and it carries the same permissions against that account's repositories —
	// but it must not be offered as somewhere a configuration could point.
	IsOrg bool
}