changeprovider

type ChangeInfo struct {
	// URI is the full change URI for correlation with the input request
	// (e.g., "github://uber/repo/pull/98/c3a4d5e6f7890123456789abcdef0123456789ab" or "phab://D123/xyz789").
	URI string
	// User is the author of the change.
	User User
	// ChangedFiles is the list of files modified in this change. Order is unspecified.
	ChangedFiles []ChangedFile
}

type ChangeProvider interface {
	// Get retrieves change information for the provided Change.
	// For a Change with multiple URIs (e.g., stacked PRs), returns one ChangeInfo per URI.
	// Returns a slice of ChangeInfo, one for each change in the stack.
	Get(ctx context.Context, change entity.Change) ([]ChangeInfo, error)
}

type ChangedFile struct {
	// Path is the file path relative to the repository root.
	Path string
	// Patch is the diff patch content for this file.
	Patch string
	// LinesAdded is the number of lines added in this file.
	LinesAdded int
	// LinesDeleted is the number of lines deleted in this file.
	LinesDeleted int
}

type Config struct {
	// QueueName identifies the queue this ChangeProvider serves.
	QueueName string
}

type Factory interface {
	// For returns the ChangeProvider for the given queue.
	For(cfg Config) (ChangeProvider, error)
}

type User struct {
	// Name is the display name of the user.
	Name string
	// Email is the email address of the user.
	Email string
}