package vcs

// ReviewEvent is the event type for a pull request review action.
type ReviewEvent string

const (
	// ReviewEventApprove approves the pull request.
	ReviewEventApprove ReviewEvent = "APPROVED"
	// ReviewEventRequestChanges requests changes to the pull request.
	ReviewEventRequestChanges ReviewEvent = "REQUEST_CHANGES"
	// ReviewEventComment posts a review comment without approval or rejection.
	ReviewEventComment ReviewEvent = "COMMENT"
)

// PullRequest holds relevant PR metadata.
type PullRequest struct {
	Title string `json:"title"`
	Body  string `json:"body"`
	Head  struct {
		SHA string `json:"sha"`
		Ref string `json:"ref"`
	} `json:"head"`
}

// ChangedFile represents a file modified in a PR.
type ChangedFile struct {
	Filename string `json:"filename"`
	Status   string `json:"status"`
}

// ContentEntry represents a file or directory entry from the contents API.
type ContentEntry struct {
	Name string `json:"name"`
	Path string `json:"path"`
	Type string `json:"type"` // "file" or "dir"
}

// Review represents a pull request review.
type Review struct {
	ID   int64  `json:"id"`
	Body string `json:"body"`
	User struct {
		Login string `json:"login"`
	} `json:"user"`
	State    string `json:"state"`
	Stale    bool   `json:"stale"`
	CommitID string `json:"commit_id"`
}

// ReviewComment represents an inline comment in a review.
// All adapters use GitHub diff-position convention:
//   - Position is a 1-indexed offset from the @@ hunk line in the unified diff.
//   - CommitID is the commit SHA the comment is anchored to.
//
// Adapters are responsible for translating to/from platform-native formats
// (e.g. Gitea uses line numbers; GitHub uses diff positions natively).
type ReviewComment struct {
	Path     string `json:"path"`
	Position int    `json:"position"` // diff-position: 1-indexed offset from @@ hunk line
	CommitID string `json:"commit_id"`
	Body     string `json:"body"`
}

// ReviewRequest is the payload for posting a review.
type ReviewRequest struct {
	// Body is the top-level review comment.
	Body string `json:"body"`
	// Event is the review action (approve, request changes, or comment).
	Event    ReviewEvent     `json:"event"`
	Comments []ReviewComment `json:"comments,omitempty"`
}