hosting

type CreateRepositoryFromTemplateOptions struct {
	Description        string
	IncludeAllBranches bool
	Private            bool
}

type CreateRepositoryOptions struct {
	Description         string
	Homepage            string
	Organization        string
	LicenseTemplate     string
	GitignoreTemplate   string
	TeamID              int64
	DisableDownloads    bool
	IsTemplate          bool
	Private             bool
	DisableWiki         bool
	AutoInit            bool
	DisableProjects     bool
	DisableIssues       bool
	PreventSquashMerge  bool
	PreventMergeCommit  bool
	PreventRebaseMerge  bool
	DeleteBranchOnMerge bool
}

type ForkRepositoryOptions struct {
	DefaultBranchOnly bool
}

type HostingService interface {
	// GetURLOf converts a repository reference to its remote URL
	GetURLOf(ref repository.Reference) (*url.URL, error)
	// ParseURL converts a remote URL to a repository reference
	ParseURL(u *url.URL) (*repository.Reference, error)
	// GetTokenFor retrieves an authentication token and user for a specific repository reference
	GetTokenFor(ctx context.Context, reference repository.Reference) (string, auth.Token, error)
	// GetRepository retrieves repository information from a remote source
	GetRepository(context.Context, repository.Reference) (*Repository, error)
	// ListRepository retrieves a list of repositories from a remote source
	ListRepository(context.Context, ListRepositoryOptions) iter.Seq2[*Repository, error]
	// DeleteRepository deletes a repository from a remote source
	DeleteRepository(context.Context, repository.Reference) error
	// CreateRepository creates a new repository on the remote hosting service
	CreateRepository(
		ctx context.Context,
		ref repository.Reference,
		opts CreateRepositoryOptions,
	) (*Repository, error)
	// CreateRepositoryFromTemplate creates a new repository from an existing template repository
	CreateRepositoryFromTemplate(
		ctx context.Context,
		ref repository.Reference,
		template repository.Reference,
		opts CreateRepositoryFromTemplateOptions,
	) (*Repository, error)
	// ForkRepository creates a fork of a repository on the remote hosting service
	ForkRepository(
		ctx context.Context,
		ref repository.Reference,
		target repository.Reference,
		opts ForkRepositoryOptions,
	) (*Repository, error)
}

type ListRepositoryOptions struct {
	// OrderBy specifies the ordering of the repositories
	OrderBy RepositoryOrder
	// Privacy specifies the privacy level of the repositories
	Privacy RepositoryPrivacy
	// OwnerAffiliations specifies the affiliations of the user to the repositories
	OwnerAffiliations []RepositoryAffiliation
	// Limit specifies the maximum number of repositories to return
	Limit int
	// IsFork filters for repositories that are forks
	IsFork Tristate
	// IsArchived filters for repositories that are archived
	IsArchived Tristate
}

type OrderDirection int

type ParentRepository struct {
	// Ref is a reference of the parent repository
	Ref repository.Reference
	// CloneURL is a clone URL for the parent repository
	CloneURL string
}

type Repository struct {
	// Ref is a reference of the repository
	Ref repository.Reference
	// URL is a full URL for the repository (e.g.: "https://github.com/kyoh86/gogh")
	URL string

	// CloneURL is a clone URL for the repository (e.g.: "https://github.com/kyoh86/gogh.git")
	CloneURL string

	// UpdatedAt is the last updated time of the repository
	UpdatedAt time.Time
	// Parent is the parent repository if it is a fork
	Parent *ParentRepository

	// Description is a description of the repository (e.g.: "Gogh is a collection of themes for Gnome Terminal and Pantheon Terminal")
	Description string
	// Homepage is a homepage of the repository (e.g.: "https://example.com")
	Homepage string
	// Language is a primary language of the repository (e.g.: "Go")
	Language string
	// Archived is if the repository is archived
	Archived bool
	// Private is if the repository is private
	Private bool
	// IsTemplate is if the repository is a template
	IsTemplate bool
	// Fork is if the repository is a fork
	Fork bool
}

type RepositoryAffiliation int

type RepositoryFormat interface {
	Format(r Repository) (string, error)
}

type RepositoryFormatFunc func(Repository) (string, error)

type RepositoryOrder struct {
	// The ordering direction.
	Direction OrderDirection `json:"direction"`
	// The field to order repositories by.
	Field RepositoryOrderField `json:"field"`
}

type RepositoryOrderField int

type RepositoryPrivacy int

type Tristate int