gitprovider

type ChangeAction int

type Config struct {
	AllowPlaintext    bool   `json:"-"`
	BaseURL           string `json:"base_url,omitempty" validate:"omitempty,url"`
	TimeoutSeconds    int    `json:"timeout_seconds,omitempty" validate:"omitempty,min=1,max=300"`
	AllowPrivateHosts bool   `json:"allow_private_hosts,omitempty"`
}

type Credentials struct {
	Token                    string  `json:"token" validate:"required,min=1"`
	GitHubContentsPermission *string `json:"-"`
}

type ProofCheck struct {
	RepositoryID, ChangeRequestID            string
	HeadSHA, ExternalID, DetailsURL, Summary string
	Conclusion                               string
	// ExistingOnly invalidates historical evidence without creating checks on closed or changed candidates.
	ExistingOnly bool
}

type ProofCheckClient interface {
	ProposalReader
	ProofCheckPublisher
}

type ProofCheckPublisher interface {
	PublishProofCheck(context.Context, ProofCheck) error
}

type ProposalClient interface {
	ProposalReader
	ListOpenProposals(ctx context.Context, req ProposalListRequest) ([]ProposalRef, error)
	CreateProposal(ctx context.Context, req ProposalRequest) (*ProposalRef, error)
	UpdateProposal(ctx context.Context, req ProposalUpdateRequest) (*ProposalRef, error)
}

type ProposalGetRequest struct {
	ProposalID string
}

type ProposalKind string

type ProposalListRequest struct {
	SourceBranch string
	TargetBranch string
}

type ProposalReader interface {
	GetProposal(ctx context.Context, req ProposalGetRequest) (*ProposalRef, error)
}

type ProposalRef struct {
	Provider     repostore.Provider
	Repository   RepositoryRef
	RepositoryID string
	ID           string
	URL          string
	SourceBranch string
	TargetBranch string
	State        ProposalState
	HeadSHA      string
	ProviderKind ProposalKind
	Closed       bool
	Merged       bool
}

type ProposalRequest struct {
	SourceBranch string
	TargetBranch string
	Title        string
	Body         string
}

type ProposalState string

type ProposalUpdateRequest struct {
	ProposalID string
	Title      string
	Body       string
}

type RepositoryBootstrapRequest struct {
	Owner         string
	Name          string
	DefaultBranch string
	Files         []RepositoryFile
	// Marker binds resumable creation to a durable, non-secret setup identity.
	Marker               string
	ExpectedRepositoryID string
}

type RepositoryBootstrapResult struct {
	Repository   RepositoryRef
	RepositoryID string
	RemoteURL    string
	HeadSHA      string
	OwnerKind    string
}

type RepositoryClient interface {
	ValidateRepository(ctx context.Context, branch string) error
	BootstrapRepository(ctx context.Context, req RepositoryBootstrapRequest) (*RepositoryBootstrapResult, error)
	DeleteRepository(ctx context.Context, repositoryID string) error
}

type RepositoryFile struct {
	Path    string
	Content string
}

type RepositoryRef struct {
	Provider    repostore.Provider
	Owner       string
	Name        string
	ProjectPath string
	FullName    string
}

type VerifiedChange struct {
	Provider             repostore.Provider
	ProviderConnectionID string
	RepositoryID         string
	ChangeRequestID      string
	HeadSHA              string
	SourceRef            string
	TargetRef            string
	PipelinePath         string
	Rerequest            bool
}

type VerifiedChangeEvent struct {
	DeliveryID           string
	BodySHA256           string
	Action               ChangeAction
	Provider             repostore.Provider
	OrganizationSlug     slug.Slug
	ProviderConnectionID string
	RepositoryID         string
	ChangeRequestID      string
	HeadSHA              string
	SourceRef            string
	TargetRef            string
	Rerequest            bool
}