service

type BlameRequest struct {
	Project   string
	Path      string
	Ref       string
	StartLine int
	EndLine   int
}

type BranchDeletion struct {
	Project string
	Branch  string
	// SHA is the head the caller read: a branch pushed to since is not
	// deleted unseen.
	SHA string
	// Unmerged allows a branch whose commits the default branch does not
	// have.
	Unmerged bool
}

type Comment struct {
	Project      string
	Type         string // issue or merge_request
	IID          int64
	Body         string
	DiscussionID string
	Location     *DiffLocation
	// Thread starts a resolvable thread rather than a standalone comment.
	Thread bool
}

type CommentDeletion struct {
	Project   string
	Type      string // issue or merge_request
	IID       int64
	NoteID    int64
	UpdatedAt string
}

type CommentEdit struct {
	Project   string
	Type      string // issue or merge_request
	IID       int64
	NoteID    int64
	Body      string
	UpdatedAt string
}

type CommitAction struct {
	Action       string // create, update, delete or move
	FilePath     string
	PreviousPath string
	Content      string
	Encoding     string // text or base64
	LastCommitID string
}

type CommitCreate struct {
	Project     string
	Branch      string
	StartBranch string
	Message     string
	Actions     []CommitAction
}

type CompareQuery struct {
	Project      string
	From, To     string
	Straight     bool
	CommitOffset int
	FileOffset   int
	DiffOffset   int
}

type DiffLocation struct {
	File    string
	Side    string // new or old
	Line    int
	EndLine int // 0 for one line
}

type DiscussionQuery struct {
	Project string
	IID     int64
	// Type is issue or merge_request: which IID names.
	Type           string
	IncludeSystem  bool
	UnresolvedOnly bool
	Max            int
	PageToken      string
	// NoteID and Offset read one comment on from an offset, when a
	// previous page cut it.
	NoteID int64
	Offset int
}

type DraftEdit struct {
	Project    string
	IID        int64
	DraftID    int64
	Body       string
	NoteSHA256 string
}

type EventQuery struct {
	Project string
	IID     int64
	// Type is issue or merge_request: which IID names.
	Type      string
	Max       int
	PageToken string
}

type IssueCreate struct {
	Project      string
	Title        string
	Description  string
	Labels       []string
	Assignees    []string
	Milestone    string
	DueDate      string
	Confidential bool
}

type IssueLinkRequest struct {
	Project       string
	IID           int64
	TargetProject string
	TargetIID     int64
	LinkType      string
}

type IssueMoveRequest struct {
	Project   string
	IID       int64
	ToProject string
	UpdatedAt string
}

type IssueUpdate struct {
	Project         string
	IID             int64
	UpdatedAt       string
	Title           *string
	Description     *string
	AddLabels       []string
	RemoveLabels    []string
	AddAssignees    []string
	RemoveAssignees []string
	Milestone       *string
	ClearMilestone  bool
	State           string // close or reopen
	DueDate         *string
	ClearDueDate    bool
	Confidential    *bool
}

type ItemSearch struct {
	Project string
	Group   string
	Query   gapi.ItemQuery
	List    gapi.ListOptions
}

type JobLogQuery struct {
	Project string
	JobID   int64
	// ByteOffset is where the window starts; nil takes the tail.
	ByteOffset *int
	// ByteLimit is the window's size; 0 takes render.JobLogBytes.
	ByteLimit  int
	FailedOnly bool
}

type JobVariable struct {
	Key   string
	Value string
}

type LabelRequest struct {
	Project          string
	LabelID          int64
	Version          string
	Name             string
	Color            string
	Description      *string
	ClearDescription bool
	Priority         *int
	ClearPriority    bool
}

type LintQuery struct {
	Project     string
	Ref         string
	Simulate    bool
	IncludeJobs bool
	Offset      int
	// Content is configuration to lint instead of the committed one.
	Content string
}

type MRVersionQuery struct {
	Project                  string
	IID                      int64
	FromVersion, ToVersion   int64
	CommitOffset, FileOffset int
	DiffOffset               int
}

type MergeRequestCreate struct {
	Project            string
	SourceBranch       string
	TargetBranch       string
	Title              string
	Description        string
	Labels             []string
	Assignees          []string
	Reviewers          []string
	Milestone          string
	Draft              bool
	RemoveSourceBranch bool
	Squash             bool
}

type MergeRequestLinkRequest struct {
	Project       string
	IID           int64
	TargetProject string
	TargetIID     int64
	LinkType      string
}

type MergeRequestMerge struct {
	Project             string
	IID                 int64
	SHA                 string
	Squash              *bool
	RemoveSourceBranch  *bool
	MergeCommitMessage  string
	SquashCommitMessage string
	AutoMerge           bool
}

type MergeRequestUpdate struct {
	Project            string
	IID                int64
	UpdatedAt          string
	Title              *string
	Description        *string
	AddLabels          []string
	RemoveLabels       []string
	AddAssignees       []string
	RemoveAssignees    []string
	AddReviewers       []string
	RemoveReviewers    []string
	Milestone          *string
	ClearMilestone     bool
	State              string
	TargetBranch       *string
	Draft              *bool
	RemoveSourceBranch *bool
	Squash             *bool
}

type MilestoneRequest struct {
	Project          string
	ID               int64
	UpdatedAt        string
	Title            string
	Description      *string
	ClearDescription bool
	DueDate          *string
	ClearDueDate     bool
	StartDate        *string
	ClearStartDate   bool
	StateEvent       string
}

type MilestoneSearch struct {
	Project          string
	Group            string
	State            string
	Search           string
	Title            string
	IncludeAncestors bool
	List             gapi.ListOptions
}

type Options struct {
	// Client is nil when nobody is signed in; every call then answers
	// [auth].
	Client  *gapi.Client
	Config  config.Config
	Granted []string
}

type PickRequest struct {
	Project string
	SHA     string
	Branch  string
	Message string
	Revert  bool
}

type PipelineRun struct {
	Project   string
	Ref       string
	Variables []PipelineVariable
	Inputs    map[string]any
}

type PipelineVariable struct {
	Key   string
	Value string
	Type  string // env_var (default) or file
}

type ProjectSearch struct {
	Search           string
	Group            string
	IncludeSubgroups bool
	// Scope is member (default), owned, starred or all.
	Scope           string
	Visibility      string
	IncludeArchived bool
	List            gapi.ListOptions
}

type Reaction struct {
	Project string
	Type    string // issue or merge_request
	IID     int64
	NoteID  int64 // 0 for the item itself
	Emoji   string
	Remove  bool
}

type Registered struct {
	Name string
	Kind scopes.Kind
}

type ReleaseCreate struct {
	Project     string
	TagName     string
	Ref         string
	TagMessage  string
	Name        string
	Description string
	Milestones  []string
	ReleasedAt  *time.Time
	Links       []gapi.ReleaseLink
}

type Rereview struct {
	Project       string
	IID           int64
	Username      string
	ReviewerState string
}

type Review struct {
	Project       string
	IID           int64
	Summary       string
	ReviewerState string
}

type ReviewComment struct {
	Project       string
	IID           int64
	Body          string
	DiscussionID  string
	ResolveThread bool
	Location      *DiffLocation
}

type SearchQuery struct {
	Project string
	Group   string
	Scope   string
	Search  string
	State   string
	Ref     string
	List    gapi.ListOptions
}

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

type SnippetCreate struct {
	Project     string // empty for a personal snippet
	Title       string
	Description string
	Files       []SnippetFile
}

type SnippetEdit struct {
	Project     string // empty for a personal snippet
	ID          int64
	Title       *string
	Description *string
	// Content replaces the file of a one-file snippet.
	Content *string
	// Files changes a snippet's files, one action each.
	Files     []SnippetFileChange
	UpdatedAt string
}

type SnippetFile struct {
	Path    string
	Content string
}

type SnippetFileChange struct {
	Action       string // create, update, delete or move
	Path         string
	PreviousPath string // the file a move starts from
	Content      string
}

type SuggestionRead struct {
	ID   int64
	Text string
}

type SuggestionsApplication struct {
	Project       string
	IID           int64
	Suggestions   []SuggestionRead
	CommitMessage string
}

type TimeTracking struct {
	Project       string
	Type          string
	IID           int64
	UpdatedAt     string
	Estimate      string
	ResetEstimate bool
	AddSpent      string
	ResetSpent    bool
	// TotalTimeSpent is the spent-time witness, the total in seconds the
	// caller read. GitLab does not move updated_at when spent time is
	// added or reset (§18 row 101), so only the total catches a repeat.
	TotalTimeSpent *int64
}

type TodoSearch struct {
	Project string
	State   string
	Action  string
	Type    string
	List    gapi.ListOptions
}

type Upload struct {
	Project string
	// Path is the image's absolute path on this machine.
	Path string
}

type WikiSave struct {
	Project       string
	Slug          string
	Title         *string
	Content       *string
	Format        string
	ContentSHA256 string
}