Configures a specific OAuth provider from database settings.

Examples

iex> PhoenixKit.Users.OAuthConfig.configure_provider(:google)
:ok

Configures all OAuth providers from database settings.

This function reads OAuth credentials from the database and updates the application configuration at runtime. It should be called:

• On application startup
• After updating OAuth credentials via admin UI

Skips configuration if OAuth is disabled in settings (oauth_enabled = false).

Examples

iex> PhoenixKit.Users.OAuthConfig.configure_providers()
:ok

Tests OAuth connection for a specific provider.

This function validates the credentials format but does not make actual API calls. For true connection testing, OAuth flow needs to be initiated through the browser.

Examples

iex> PhoenixKit.Users.OAuthConfig.test_connection(:google)
{:ok, "Google OAuth credentials are properly formatted"}

Tests OAuth credentials for a specific provider against an explicit credentials map, instead of reading from the database.

Use this to validate unsaved form values (e.g. an admin "Test Credentials" button) before the settings are saved — test_connection/1 would otherwise validate the stale, already-persisted credentials.

Examples

iex> PhoenixKit.Users.OAuthConfig.test_connection(:google, %{client_id: "x", client_secret: "y"})
{:ok, "Google OAuth credentials are properly formatted. Initiate OAuth flow to test actual connection."}

Validates OAuth credentials for a specific provider.

Returns {:ok, provider} if credentials are valid, or {:error, reason} if not. Uses direct database read for accurate validation.

Examples

iex> PhoenixKit.Users.OAuthConfig.validate_credentials(:google)
{:ok, :google}