Gemini.Auth (GeminiEx v0.9.0)

Authentication strategy behavior and implementations for Gemini and Vertex AI.

This module provides a unified interface for different authentication methods:

Summary

auth_type()

credentials()

Build authenticated headers for the given strategy and credentials.

Build the full path for an API endpoint.

Get the base URL for the given strategy and credentials.

Get the appropriate authentication strategy based on configuration.

Refresh credentials if needed (mainly for Vertex AI OAuth tokens).

@type auth_type() :: :gemini | :vertex_ai

@type credentials() ::
  %{api_key: String.t()}
  | %{access_token: String.t(), project_id: String.t(), location: String.t()}

@spec build_headers(auth_type(), map()) ::
  {:ok, [{String.t(), String.t()}]} | {:error, term()}

Build authenticated headers for the given strategy and credentials.

Returns {:ok, headers} on success, or {:error, reason} if authentication fails (e.g., service account token generation failure).

@spec build_path(auth_type(), String.t(), String.t(), map()) :: String.t()

Build the full path for an API endpoint.

@spec get_base_url(auth_type(), map()) :: String.t() | {:error, term()}

Get the base URL for the given strategy and credentials.

@spec get_strategy(auth_type()) :: module()

Get the appropriate authentication strategy based on configuration.

@spec refresh_credentials(auth_type(), map()) :: {:ok, map()} | {:error, term()}

Refresh credentials if needed (mainly for Vertex AI OAuth tokens).