interfaces

type EvaluationResult struct {
	// Output is the output of the evaluation. This contains a list of additional
	// information about the evaluation, which may be used in downstream actions.
	Output any
}

type Evaluator interface {
	Eval(ctx context.Context, profile map[string]any, entity protoreflect.ProtoMessage, data *Ingested) (*EvaluationResult, error)
}

type GitHubIssuePRClient interface {
	ListReviews(ctx context.Context, owner, repo string, number int, opts *github.ListOptions) (
		[]*github.PullRequestReview, error)
	CreateReview(ctx context.Context, owner, repo string, number int, review *github.PullRequestReviewRequest) (
		*github.PullRequestReview, error)
	DismissReview(ctx context.Context, owner, repo string, number int, reviewID int64,
		req *github.PullRequestReviewDismissalRequest) (
		*github.PullRequestReview, error)
	SetCommitStatus(ctx context.Context, owner, repo string, sha string, status *github.RepoStatus) (*github.RepoStatus, error)
	ListIssueComments(ctx context.Context, owner, repo string, number int, opts *github.IssueListCommentsOptions) (
		[]*github.IssueComment, error)
	CreateIssueComment(ctx context.Context, owner, repo string, number int, comment string) (*github.IssueComment, error)
	UpdateIssueComment(ctx context.Context, owner, repo string, id int64, comment string) error
}

type GitHubListAndClone interface {
	ListFiles(ctx context.Context, owner, repo string, prNumber int, perPage, page int) (
		[]*github.CommitFile, *github.Response, error)
	Clone(ctx context.Context, repoURL, ref string) (*git.Repository, error)
}

type GitProvider interface {
	// Clone clones a git repository.  This provides a full git Repository
	// which can be used to create new commits, etc.
	Clone(ctx context.Context, url string, branch string) (*git.Repository, error)
}

type Ingested struct {
	// Object is the object that was ingested. Normally comes from an external
	// system like an HTTP server.
	Object any
	// Fs is the filesystem that was created as a result of the ingestion. This
	// is normally used by the evaluator to do rule evaluation. The filesystem
	// may be a git repo, or a memory filesystem.
	Fs billy.Filesystem
	// BaseFs is the base filesystem for a pull request.  It can be used in the
	// evaluator for diffing the PR target files against the base files.
	BaseFs billy.Filesystem
	// Storer is the git storer that was created as a result of the ingestion.
	// FIXME: It might be cleaner to either wrap both Fs and Storer in a struct
	// or pass out the git.Repository structure instead of the storer.
	Storer storage.Storer

	// Checkpoint is the checkpoint at which the ingestion was done. This is
	// used to persist the state of the entity at ingestion time.
	Checkpoint *checkpoints.CheckpointEnvelopeV1
}

type Ingester interface {
	// Ingest does the actual data ingestion for a rule type
	Ingest(ctx context.Context, ent protoreflect.ProtoMessage, params map[string]any) (*Ingested, error)
	// GetType returns the type of the ingester
	GetType() string
	// GetConfig returns the config for the ingester
	GetConfig() protoreflect.ProtoMessage
}

type Provider interface {
}

type RESTProvider interface {
	NewRequest(method, url string, body any) (*http.Request, error)
	Do(ctx context.Context, req *http.Request) (*http.Response, error)
}

type ResultSink interface {
	SetIngestResult(*Ingested)
}

type SelfAwareness interface {
	// GetUserId returns the ID of the authenticated user.
	GetUserId(ctx context.Context) (int64, error)
}