elogin

type AuthAccessor interface {
	// Provider returns the name of the authentication provider (e.g., "google", "github").
	Provider() string

	// Protocol returns the protocol used by the provider (e.g., "oauth2", "saml").
	Protocol() string

	// LoginURL generates the login URL with the provided URL parameters.
	LoginURL(urlParams []URLParam) string

	// UserData exchanges authentication values for user information and token.
	// It takes a context, URL values from the callback, and URL parameters,
	// returning the token, user data, or an error.
	UserData(ctx context.Context, values url.Values, urlParams []URLParam) (*Token, *UserData, error)
}

type AuthHTTPWrapper struct {
	Auth           AuthAccessor
	Error          ErrorHandler
	Success        SuccessHandler
	RedirectParams RedirectParamsExtractor
}

type ErrorHandler interface {
	Error(w http.ResponseWriter, r *http.Request, err error)
}

type RedirectParamsExtractor interface {
	RedirectParams(w http.ResponseWriter, r *http.Request, login bool) []URLParam
}

type SuccessHandler interface {
	Success(w http.ResponseWriter, r *http.Request, token *Token, data *UserData)
}

type Token struct {
	TokenType    string    `json:"token_type,omitempty"`
	AccessToken  string    `json:"access_token"`
	RefreshToken string    `json:"refresh_token"`
	ExpiresAt    time.Time `json:"expires_at,omitempty"`
	Scopes       []string  `json:"scopes,omitempty"`
}

type URLParam struct {
	Key   string
	Value string
}

type UserData struct {
	// ID is the unique identifier of the user
	ID string `json:"id"`

	// Email is the user's email address
	Email string `json:"email"`

	// FirstName is the user's first name
	FirstName string `json:"first_name"`

	// LastName is the user's last name
	LastName string `json:"last_name"`

	// Username is the user's username or handle
	Username string `json:"username"`

	// AvatarURL is the URL to the user's avatar image
	AvatarURL string `json:"avatar_url"`

	// Link is the user's profile link or homepage URL
	Link string `json:"link"`

	// Ext contains additional provider-specific user data
	Ext map[string]any `json:"ext,omitempty"`

	// OAuth2conf is the OAuth2 configuration (excluded from JSON serialization)
	OAuth2conf *oauth2.Config `json:"-"`
}