circleciapp

type CircleCI interface {
	GetProject(ctx context.Context, org, repo string) (*circleciclient.Project, error)
	ListPipelineDefinitions(ctx context.Context, projectID string) ([]circleciclient.PipelineDefinition, error)
	CreatePipelineDefinition(ctx context.Context, projectID string, def circleciclient.PipelineDefinition) (*circleciclient.PipelineDefinition, error)
	ListTriggers(ctx context.Context, projectID, definitionID string) ([]circleciclient.Trigger, error)
	CreateTrigger(ctx context.Context, projectID, definitionID string, trigger circleciclient.Trigger) (*circleciclient.Trigger, error)
	DeleteTrigger(ctx context.Context, projectID, triggerID string) error
	RunPipeline(ctx context.Context, org, repo, definitionID string, ref circleciclient.Ref) (*circleciclient.Pipeline, error)
	GetPipeline(ctx context.Context, id string) (*circleciclient.PipelineDetail, error)
	GetProjectSettings(ctx context.Context, org, repo string) (*circleciclient.ProjectSettings, error)
	UpdateProjectSettings(ctx context.Context, org, repo string, settings circleciclient.ProjectSettings) (*circleciclient.ProjectSettings, error)
	ListPipelineWorkflows(ctx context.Context, pipelineID string) ([]circleciclient.Workflow, error)
}

type GitHub interface {
	// Repository returns GitHub's id of owner/repo and its default branch.
	Repository(ctx context.Context, owner, repo string) (id int64, defaultBranch string, err error)
	// LatestRelease returns the repository's latest release, nil when it has
	// none.
	LatestRelease(ctx context.Context, owner, repo string) (*github.RepositoryRelease, error)
	// Releases returns the repository's published releases, drafts and
	// pre-releases left out.
	Releases(ctx context.Context, owner, repo string) ([]*github.RepositoryRelease, error)
	// CircleCIStatuses returns the CircleCI statuses of ref's commit, newest
	// first.
	CircleCIStatuses(ctx context.Context, owner, repo, ref string) ([]*github.RepoStatus, error)
	// HasConfig says whether ref carries .circleci/config.yml.
	HasConfig(ctx context.Context, owner, repo, ref string) (bool, error)
	// CommitSHA returns the commit ref points at.
	CommitSHA(ctx context.Context, owner, repo, ref string) (string, error)
}

type Options struct {
	// Migrate deletes the OAuth pipeline's triggers (Ensure).
	Migrate bool
	// Wait follows the runs Setup starts until they settle.
	Wait bool
	// Waiter follows them when Wait is set.
	Waiter Waiter
	// Progress receives one line per step; nil discards.
	Progress func(format string, args ...any)
	// Now is the clock; nil means time.Now.
	Now func() time.Time
}

type Outcome struct {
	Pipeline circleciclient.Pipeline
	// Green says every workflow succeeded; Failed names the ones that did
	// not, with their status.
	Green  bool
	Failed []string
	// OnHold names the workflows waiting for an approval: settled as far as
	// the wait goes, a person approves them in the CircleCI UI.
	OnHold []string
}

type Report struct {
	Result *Result
	Runs   []Run
}

type Repository struct {
	Owner, Name string
	ID          int64
}

type Result struct {
	ProjectID string
	// Definition is the GitHub App pipeline, found or created.
	Definition circleciclient.PipelineDefinition
	// CreatedDefinition and CreatedTrigger say Ensure created them.
	CreatedDefinition, CreatedTrigger bool
	// OAuthTriggers are the enabled triggers of the OAuth pipeline left in
	// place (without migrate): every push builds on both pipelines.
	OAuthTriggers []string
	// DeletedOAuthTriggers are the OAuth pipeline's triggers migrate
	// deleted.
	DeletedOAuthTriggers []string
	// EnabledSetupWorkflows says Ensure switched the project's setup
	// workflows on.
	EnabledSetupWorkflows bool
	// SetupWorkflowsUnread is why the setting could not be read or written,
	// empty when it was: CircleCI may refuse the person its project
	// settings, and a project created since late 2023 has them on anyway.
	SetupWorkflowsUnread string
}

type Run struct {
	Ref      circleciclient.Ref
	Pipeline circleciclient.Pipeline
	Outcome  *Outcome
}

type Waiter struct {
	CircleCI CircleCI
	// Sleep waits between reads; Interval is how long.
	Sleep    func(ctx context.Context, d time.Duration) error
	Interval time.Duration
}