github

type App struct {
	ProjectID          string
	AppID              string
	Repo               string // "owner/name"
	InstallationID     int64
	WebhookSecret      []byte // unsealed HMAC secret
	BranchEnvironments map[string]string
}

type AppStore interface {
	AppByRepo(repo string) (*App, bool)
}

type Commenter interface {
	CommentPR(ctx context.Context, token, repo string, pr int64, body string) error
}

type Deduper interface {
	Seen(deliveryID string) bool
}

type Deployer interface {
	DeployGit(ctx context.Context, app *App, envName, branch, sha, cloneURL, token string) (deploymentID string, err error)
}

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

type Option func(*GitHubApp)

type PreviewEnv struct {
	ID        string
	Name      string
	AppID     string
	ProjectID string
	PRNumber  int64
	// HeadSHA is the commit of the environment's newest release, used to skip
	// redundant rebuilds when GitHub replays a synchronize for a SHA we already
	// deployed (force-push storms send several in a row).
	HeadSHA   string
	ExpiresAt time.Time
}

type PreviewStore interface {
	// ListPreviews returns the app's current preview environments.
	ListPreviews(appID string) []PreviewEnv
	// AllPreviews returns every preview environment in the cluster (janitor).
	AllPreviews() []PreviewEnv
	// CreatePreview creates a PREVIEW environment named name, cloning its
	// service spec from the app's base (staging) environment.
	CreatePreview(ctx context.Context, app *App, name string, pr int64, expiresAt time.Time) (PreviewEnv, error)
	// TouchPreview extends an existing preview's TTL.
	TouchPreview(ctx context.Context, env PreviewEnv, expiresAt time.Time) error
	// DeletePreview removes the environment; teardown of its containers is a
	// cascade handled by the scheduler's orphan reconciler.
	DeletePreview(ctx context.Context, env PreviewEnv) error
	// PreviewURL renders the public URL an environment is reachable at.
	PreviewURL(app *App, envName string) string
}

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

type PullRequestEvent struct {
	Action   string
	Number   int64
	Branch   string // head ref
	HeadSHA  string
	CloneURL string
}

type TokenSource interface {
	InstallationToken(ctx context.Context, installationID int64) (string, error)
}

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