gitlabx

type Client struct {
	// contains filtered or unexported fields
}

type Commit struct {
	ShortID string
	Title   string
	Message string // full message (subject + body)
}

type DiffRefs struct {
	BaseSHA  string
	HeadSHA  string
	StartSHA string
}

type Discussion struct {
	ID    string
	Notes []Note
}

type FileDiff struct {
	OldPath       string
	NewPath       string
	Diff          string
	NewFile       bool
	RenamedFile   bool
	DeletedFile   bool
	GeneratedFile bool
	TooLarge      bool
}

type GroupInfo struct {
	ID          int64
	FullPath    string
	Name        string
	Description string
}

type MRDetail struct {
	MRSummary
	DiffRefs DiffRefs
	// HasConflicts and DivergedCommits drive the rebase hygiene check:
	// DivergedCommits > 0 means the target branch moved ahead.
	HasConflicts        bool
	DivergedCommits     int64
	DetailedMergeStatus string
}

type MRFilter struct {
	State          string // opened | merged | closed | all
	AuthorUsername string
	TargetBranch   string
	Search         string

	// Projects/Groups override the configured scope for this query (used
	// by in-TUI selection). Both empty = use the configured scope.
	Projects []string
	Groups   []string
}

type MRSummary struct {
	ProjectID    int64
	ProjectPath  string // full path with namespace; may be empty if unknown
	IID          int64
	Title        string
	Description  string
	State        string
	Draft        bool
	Author       string
	SourceBranch string
	TargetBranch string
	HeadSHA      string
	WebURL       string
	CreatedAt    time.Time
	UpdatedAt    time.Time
}

type Note struct {
	ID        int64
	Author    string
	Body      string
	System    bool
	Resolved  bool
	CreatedAt time.Time
	Position  *Position // nil for general (unpositioned) notes
}

type Page struct {
	Number  int
	PerPage int
}

type Position struct {
	BaseSHA  string
	HeadSHA  string
	StartSHA string
	OldPath  string
	NewPath  string
	OldLine  *int
	NewLine  *int
}

type ProjectInfo struct {
	ID                int64
	PathWithNamespace string
	Description       string
	LastActivity      time.Time
}

type Service interface {
	// ListOpenMergeRequests returns one page of MRs merged across the
	// scope (filter override or the configured projects and groups),
	// newest-updated first, and whether any source has more pages.
	ListOpenMergeRequests(ctx context.Context, filter MRFilter, page Page) ([]MRSummary, bool, error)

	// ListGroups returns groups the user has access to, for in-TUI scope
	// selection.
	ListGroups(ctx context.Context, search string, page Page) ([]GroupInfo, bool, error)

	// ListGroupProjects returns a group's projects (including subgroups).
	ListGroupProjects(ctx context.Context, group string, search string, page Page) ([]ProjectInfo, bool, error)

	// ListMemberProjects returns projects the user is a member of,
	// covering personal and directly-shared projects outside any group.
	ListMemberProjects(ctx context.Context, search string, page Page) ([]ProjectInfo, bool, error)

	// GetMergeRequest fetches full MR details including diff refs.
	// project is a full path (group/app) or numeric ID.
	GetMergeRequest(ctx context.Context, project any, iid int64) (*MRDetail, error)

	// ListDiffs returns every file diff of the MR (paginating internally).
	ListDiffs(ctx context.Context, project any, iid int64) ([]FileDiff, error)

	// ListCommits returns every commit on the MR's source branch
	// (paginating internally), for commit-message hygiene checks.
	ListCommits(ctx context.Context, project any, iid int64) ([]Commit, error)

	// GetMergeRequestTemplate resolves the project's default MR description
	// template (including group-inherited ones), or "" if none is set.
	GetMergeRequestTemplate(ctx context.Context, project any) (string, error)

	// ListDiscussions returns every discussion thread on the MR
	// (paginating internally).
	ListDiscussions(ctx context.Context, project any, iid int64) ([]Discussion, error)

	// CreateInlineDiscussion posts a positioned comment on the MR diff.
	CreateInlineDiscussion(ctx context.Context, project any, iid int64, body string, pos *Position) error

	// CreateNote posts a general (unpositioned) comment on the MR — the
	// fallback when no diff position can be resolved.
	CreateNote(ctx context.Context, project any, iid int64, body string) error

	// CreateDraftNote adds a comment to the user's pending review; pos may
	// be nil for a general draft note. Nothing is visible to others until
	// PublishAllDraftNotes.
	CreateDraftNote(ctx context.Context, project any, iid int64, body string, pos *Position) error

	// PublishAllDraftNotes publishes the pending review in one action.
	PublishAllDraftNotes(ctx context.Context, project any, iid int64) error
}