operations

type BitbucketConfig struct {
	Token    string `toml:"token"`
	Username string `toml:"username"`
}

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

type Config struct {
	GitHub    GitHubConfig    `toml:"github"`
	GitLab    GitLabConfig    `toml:"gitlab"`
	Forgejo   ForgejoConfig   `toml:"forgejo"`
	SourceHut SourceHutConfig `toml:"sourcehut"`
	Bitbucket BitbucketConfig `toml:"bitbucket"`

	// Instances holds additional instances of any forge type. Each entry must
	// set Type (github, gitlab, forgejo, sourcehut, bitbucket) and Name.
	Instances []Instance `toml:"instance"`
}

type FetchSpec struct {
	// Remote is the local repository remote name to fetch from.
	Remote string
	// Refspecs are the refspecs to fetch. Fetching an empty list falls back to
	// the remote's configured fetch refspec.
	Refspecs []string
	// LocalBranch is the branch name to create for the pull request. Ignored
	// when the caller asks to detach.
	LocalBranch string
	// HeadSHA is the resolved head commit, used to verify the checkout landed on
	// the commit the forge reports.
	HeadSHA string
	// ForkURL is set when the head branch exists only on a fork, so the fetch
	// must target that clone URL instead of the configured remote. When set, the
	// caller registers it as an additional remote before fetching.
	ForkURL string
}

type ForgejoConfig struct {
	Token string `toml:"token"`
	URL   string `toml:"url"`
}

type Gist struct {
	ID          string              `json:"id"`
	Description string              `json:"description"`
	Public      bool                `json:"public"`
	URL         string              `json:"html_url"`
	Files       map[string]GistFile `json:"files"`
}

type GistFile struct {
	Filename string `json:"filename"`
	Content  string `json:"content"`
}

type GistInput struct {
	Description string
	Public      bool
	Files       map[string]string // filename -> content
}

type GitHubConfig struct {
	Token string `toml:"token"`
}

type GitLabConfig struct {
	Token string `toml:"token"`
	URL   string `toml:"url"`
}

type Instance struct {
	Name     string `toml:"name"`
	Type     string `toml:"type"`
	Driver   string `toml:"driver"`
	Token    string `toml:"token"`
	URL      string `toml:"url"`
	Username string `toml:"username"`
}

type Issue struct {
	Forge    string // forge type
	Instance string // instance name
	Repo     string // repository (or tracker) name
	Number   int
	Title    string
	State    string
	URL      string
}

type IssueDetail struct {
	Forge    string
	Instance string
	Repo     string
	Number   int
	Title    string
	State    string // open, closed
	URL      string
	Body     string

	Author string
	Labels []string

	Assignees []string

	CreatedAt time.Time
	UpdatedAt time.Time
}

type IssueInput struct {
	Repo  string
	Title string
	Body  string
	// Labels are label names to apply, when the forge supports labels.
	Labels []string
}

type MergeOptions struct {
	// MergeMethod is one of merge, squash or rebase. Forges that do not offer
	// a choice ignore it.
	MergeMethod string
	// DeleteBranch asks the forge to delete the head branch after merging.
	DeleteBranch bool
	// Title and OptionalMessage override the generated merge commit message.
	Title           string
	OptionalMessage string
}

type PR struct {
	Forge    string // forge type
	Instance string // instance name
	Repo     string // repository (or mailing list) name
	Number   int
	Title    string
	State    string
	URL      string
}

type PRDetail struct {
	Forge    string
	Instance string
	Repo     string
	Number   int
	Title    string
	State    string // open, closed, merged
	URL      string
	Body     string

	Draft  bool
	Merged bool

	Author string
	Labels []string

	HeadBranch string
	HeadSHA    string
	HeadOwner  string // owner of the head repository, for cross-fork PRs
	// HeadRepoName is the head repository's slug without its namespace. It is
	// used to build a fork clone URL on forges that have no pull request ref
	// namespace, where the head branch must be fetched from the fork.
	HeadRepoName string
	BaseBranch   string

	CreatedAt time.Time
	UpdatedAt time.Time
}

type PRInput struct {
	Repo  string
	Title string
	Body  string
	Base  string // base branch; defaults to the repository's default branch
	Head  string // head branch; defaults to the current branch
	Draft bool
}

type Project struct {
	Forge    string // forge type
	Instance string // instance name
	FullName string // name or owner/name
	URL      string
	Private  bool
}

type Repo struct {
	Forge    string // forge type: github, gitlab, forgejo, sourcehut, bitbucket
	Instance string // instance name (e.g. "gitlab-main"); forge type when unnamed
	FullName string // owner/name
	URL      string // web URL
	Private  bool
}

type RepoInput struct {
	Name        string // required
	Owner       string // optional; defaults to the authenticated user
	Description string
	Private     bool
}

type Run struct {
	Forge    string // forge type
	Instance string // instance name
	Repo     string // repository name
	ID       int64
	Name     string
	Status   string
	Branch   string
	URL      string
}

type SourceHutConfig struct {
	Token    string `toml:"token"`
	Username string `toml:"username"`
}

type Workflow struct {
	Forge    string // forge type
	Instance string // instance name
	Repo     string // repository name
	ID       int64
	Name     string
	State    string // e.g. active, disabled
	URL      string
}