githubapp

type AppCredentials struct {
	AppID         int64  // numeric GitHub App ID
	Slug          string // URL slug, e.g. "stackdome-ci"
	PEM           string // RSA private key (PEM) used to sign app JWTs
	WebhookSecret string // secret for verifying webhook payload signatures
	ClientID      string // OAuth client ID
	ClientSecret  string // OAuth client secret
}

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

type AppManifest struct {
	Name               string            `json:"name"`
	URL                string            `json:"url"`
	RedirectURL        string            `json:"redirect_url"`
	SetupURL           string            `json:"setup_url"`
	Public             bool              `json:"public"`
	HookAttributes     AppHookAttributes `json:"hook_attributes"`
	DefaultPermissions map[string]string `json:"default_permissions"`
	DefaultEvents      []string          `json:"default_events"`
}

type Client interface {
	// ConvertManifestCode exchanges the temporary code from the manifest
	// redirect for the newly created app's credentials.
	ConvertManifestCode(ctx context.Context, code string) (*AppCredentials, error)
	// ListInstallations lists every installation of the app (app JWT auth),
	// following pagination.
	ListInstallations(ctx context.Context, creds *AppCredentials) ([]Installation, error)
	// GetInstallation fetches one installation of the app by its GitHub id.
	GetInstallation(ctx context.Context, creds *AppCredentials, installationID int64) (*Installation, error)
	// DeleteInstallation uninstalls the app from the installation's account.
	DeleteInstallation(ctx context.Context, creds *AppCredentials, installationID int64) error
	// MintInstallationToken creates a short-lived installation access token.
	MintInstallationToken(ctx context.Context, creds *AppCredentials, installationID int64) (*Token, error)
	// ListInstallationRepos lists one page of repositories the installation
	// can access.
	ListInstallationRepos(ctx context.Context, creds *AppCredentials, installationID int64, page int) (*RepoPage, error)
	// GetRepo fetches repository details through the installation.
	GetRepo(ctx context.Context, creds *AppCredentials, installationID int64, owner, repo string) (*Repo, error)
	// ListBranches lists branch names through the installation.
	ListBranches(ctx context.Context, creds *AppCredentials, installationID int64, owner, repo string) ([]string, error)
}

type ClientSpec struct {
	// BaseURL is optional; it defaults to the public GitHub API. Set it to a
	// GitHub Enterprise or test-server URL to point the client elsewhere.
	BaseURL string
	// HTTPClient is optional. Its Transport is used as the base round-tripper
	// beneath the app-JWT / installation-token auth transports, and its Timeout
	// (when set) overrides the 30s default.
	HTTPClient *http.Client
}

type Installation struct {
	ID                  int64
	AccountLogin        string // account (user or org) the app is installed on
	AccountType         string // "User" or "Organization"
	RepositorySelection string // "all" or "selected"
	Suspended           bool   // true when the installation is suspended and cannot be used
}

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

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

type PullRequestCommenter interface {
	CreateComment(ctx context.Context, token, owner, repo string, prNumber int, body string) (int64, error)
	EditComment(ctx context.Context, token, owner, repo string, commentID int64, body string) error
}

type PullRequestCommenterSpec struct {
	// BaseURL overrides the GitHub API base URL (tests); empty uses api.github.com.
	BaseURL string
}

type Repo struct {
	FullName      string // "owner/name"
	CloneURL      string // HTTPS clone URL
	DefaultBranch string
	Private       bool
	PushedAt      *time.Time // last push time; nil if never pushed
	OwnerLogin    string
}

type RepoPage struct {
	Repos      []Repo
	Page       int
	TotalCount int
	HasNext    bool
}

type Token struct {
	Value     string
	ExpiresAt time.Time
}