package classes

import "context"

// OAuthProvider is one social sign-in provider as GET
// /_user/api/v1/oauth-providers lists it: Name is the route segment
// (/oauth/{name}) and Label the button text.
type OAuthProvider struct {
	Name  string `json:"name"`
	Label string `json:"label"`
}

// OAuthProviderSource is what a social-login plugin publishes so the user
// plugin can list its providers and accept them in the unlink routes. The
// user plugin looks it up on every request, so a plugin that boots later is
// still found.
//
// Publish it with an explicit type argument,
//
//	app.Publish[classes.OAuthProviderSource](src)
//
// because a bare app.Publish(src) keys the service on its concrete type and
// the lookup misses it (the list then stays empty).
type OAuthProviderSource interface {
	// EnabledOAuthProviders returns the providers that are configured right
	// now, in display order.
	EnabledOAuthProviders(ctx context.Context) []OAuthProvider
	// KnownOAuthProviders returns the name of every registered provider,
	// enabled or not: an identity of any of them may be unlinked.
	KnownOAuthProviders() []string
}