provider

type BaseClient struct {
	oauth2.Config

	// Host is the host of the server acting as the OAuth client for the
	// provider's OAuth server.
	Host string

	// APIEndpoint is the full URL where the provider's REST API is located.
	APIEndpoint string

	// State is the string used for verifying the final token exchange in the
	// webflow.
	State string

	// Secret is the secret that is set on each webhook created to verify the
	// request body sent by the provider.
	Secret string
}

type Client interface {
	// Auth performs the final token exchange in the webflow. Upon success this
	// will return the access token, refresh token, and the details of the
	// User who successfully authenticated.
	Auth(context.Context, url.Values) (string, string, User, error)

	// AuthURL returns the full URL for authenticating against a provider and
	// starting the token exchange webflow.
	AuthURL() string

	// Repos returns a list of repos from the provider the user either owns or
	// has access to (via a group). The given page delineates which page of
	// repositories to get if there are multiple pages. A database.Paginator is
	// returned if there are multiple pages. This should return the repositories
	// ordered by when they were last updated.
	Repos(string, int64) ([]*Repo, database.Paginator, error)

	// Groups returns the ID of groups that a user is a member of from the
	// provider (if any/supported). This will be used to create multiple
	// providers in the database for each group, allowing for easy lookup
	// during webhook execution, should any webhook contain a group ID in place
	// of a user ID.
	Groups(string) ([]int64, error)

	// ToggleRepo will toggle the webhook for the given Repo using the given
	// string as the authentication token. This will create a webhook if it
	// doesn't exist for the Repo, otherwise it will delete it.
	ToggleRepo(string, *Repo) error

	// SetCommitStatus will set the commit status for the given commit hash to
	// the given runner.Status. This should only be called on commits that
	// belong to a merge or pull request.
	SetCommitStatus(string, *Repo, runner.Status, string, string) error

	// VerifyRequest verifies the contents of the given io.Reader against the
	// given string secret. This is typically used for verifying the contents
	// of a webhook that has been sent from said provider. Upon success it will
	// return a byte slice read from the given io.Reader.
	VerifyRequest(io.Reader, string) ([]byte, error)
}

type Factory func(string, string, string, string, string) Client

type Provider struct {
	ID             int64         `db:"id"`
	UserID         int64         `db:"user_id"`
	ProviderUserID sql.NullInt64 `db:"provider_user_id"`
	Name           string        `db:"name"`
	AccessToken    []byte        `db:"access_token"`
	RefreshToken   []byte        `db:"refresh_token"`
	Connected      bool          `db:"connected"`
	MainAccount    bool          `db:"main_account"`
	ExpiresAt      time.Time     `db:"expires_at"`
	AuthURL        string        `db:"-"`

	User *user.User `db:"-"`
}

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

type Repo struct {
	ID             int64         `db:"id"`
	UserID         int64         `db:"user_id"`
	ProviderID     int64         `db:"provider_id"`
	ProviderUserID int64         `db:"-"`
	HookID         sql.NullInt64 `db:"hook_id"`
	RepoID         int64         `db:"repo_id"`
	ProviderName   string        `db:"provider_name"`
	Enabled        bool          `db:"enabled"`
	Name           string        `db:"name"`
	Href           string        `db:"href"`

	User     *user.User `db:"-"`
	Provider *Provider  `db:"-"`
}

type RepoForm struct {
	ProviderID int64  `schema:"provider_id"`
	RepoID     int64  `schema:"repo_id"`
	Name       string `schema:"name"`
	Href       string `schema:"href"`
}

type RepoStore struct {
	database.Store

	// User is the bound user.User model. If not nil this will bind the
	// user.User model to any Repo models that are created. If not nil this
	// will append a WHERE clause on the user_id column for all SELECT queries
	// performed.
	User *user.User

	// Provider is the bound Provider model. If not nil this will bind the
	// Provider model to any Repo models that are created. If not nil this will
	// append a WHERE clause on the provider_id column for all SELECT queries
	// performed.
	Provider *Provider
}

type Store struct {
	database.Store

	// User is the bound user.User model. If not nil this will bind the
	// user.User model to any Provider models that are created. If not nil this
	// will append a WHERE clause on the user_id column for all SELECT queries
	// performed.
	User *user.User
}

type User struct {
	ID       int64  // ID of the user from the provider.
	Email    string // Email of the user from the provider.
	Login    string // Login of the user from the provider, this is only used for GitHub.
	Username string // Username of the user from the provider.
}