Struct AuthClient 

pub struct AuthClient { /* private fields */ }

Firebase Authentication client.

A single concrete type serves both live and emulator use: mode is a runtime field (ClientMode), not a type parameter, so every method below has exactly one signature regardless of environment. Build one with AuthClientBuilder.

Implementations

impl AuthClient

pub fn builder(project_id: impl Into<String>) -> AuthClientBuilder

Starts building a new client for the given Firebase project.

pub fn project_id(&self) -> &ProjectId

Returns the Firebase project id this client is configured for.

pub async fn verify_id_token( &self, token: &str, ) -> Result<IdTokenClaims, AuthError>

Verifies a Firebase ID token, returning its claims.

pub fn create_custom_token( &self, uid: &str, claims: Option<Map<String, Value>>, ) -> Result<String, AuthError>

Creates a Firebase custom token for the given uid.

Requires the client to have been built with an explicit service account key; Application Default Credentials do not expose a private key and cannot sign custom tokens.

pub async fn create_session_cookie( &self, id_token: &str, valid_duration: Duration, ) -> Result<String, AuthError>

Exchanges a verified ID token for a session cookie valid for valid_duration (Firebase allows up to 14 days).

pub async fn verify_session_cookie( &self, cookie: &str, ) -> Result<IdTokenClaims, AuthError>

Verifies a Firebase session cookie, returning its claims.

Verified against a different certificate endpoint and issuer than Self::verify_id_token — see crate::auth::session_cookie::verify for why the two aren’t interchangeable.

pub async fn get_user(&self, uid: &str) -> Result<UserRecord, AuthError>

Fetches a user by uid.

pub async fn get_user_by_email( &self, email: &str, ) -> Result<UserRecord, AuthError>

Fetches a user by email address.

pub async fn create_user( &self, request: CreateUserRequest, ) -> Result<UserRecord, AuthError>

Creates a new user.

pub async fn update_user( &self, uid: &str, request: UpdateUserRequest, ) -> Result<UserRecord, AuthError>

Updates an existing user.

pub async fn set_custom_user_claims( &self, uid: &str, claims: Map<String, Value>, ) -> Result<(), AuthError>

Replaces a user’s custom claims.

pub async fn delete_user(&self, uid: &str) -> Result<(), AuthError>

Deletes a user by uid.

pub async fn list_users( &self, max_results: u32, page_token: Option<&str>, ) -> Result<UserPage, AuthError>

Lists users, paginated via next_page_token.