@spec create_handler(
  handler_or_config ::
    Lightning.AuthProviders.Handler.t() | Lightning.AuthProviders.AuthConfig.t()
) :: {:ok, Lightning.AuthProviders.Handler.t()} | {:error, term()}

@spec get_authorize_url(String.t() | Lightning.AuthProviders.Handler.t()) ::
  String.t() | nil

@spec get_existing() :: Lightning.AuthProviders.AuthConfig.t() | nil

@spec get_existing(name :: String.t()) :: Lightning.AuthProviders.AuthConfig.t() | nil

@spec get_handler(name :: String.t()) ::
  {:ok, Lightning.AuthProviders.Handler.t()} | {:error, :not_found}

@spec get_handlers() :: {:ok, [Lightning.AuthProviders.Handler.t()]}

@spec remove_handler(
  name_or_handler :: String.t() | Lightning.AuthProviders.Handler.t()
) :: {:ok, true}