Struct FirebaseRTDB

pub struct FirebaseRTDB {
    pub base_url: String,
    pub auth: AuthResponsePayload,
    pub expire_time: Instant,
    pub api_key: String,
    pub jwt: String,
    /* private fields */
}

Firebase Realtime Database client with JWT authentication support.

This struct maintains the authentication state and provides access to database operations. It automatically handles token renewal and maintains connection settings.

Fields

• base_url - The base URL of your Firebase project
• client - HTTP client with connection pooling and TLS support
• auth - Current authentication state including tokens
• expire_time - Token expiration timestamp
• api_key - Firebase project API key
• jwt - Original JWT token for renewals

Fields

base_url: String

auth: AuthResponsePayload

expire_time: Instant

api_key: String

jwt: String

Implementations

impl FirebaseRTDB

pub async fn new_from_jwt<T: Into<String>, R: Into<String>, V: AsRef<str>>( project_url: T, jwt: R, api_key: V, ) -> Result<Self, RtdbError>

Creates a new Firebase RTDB client using a JWT token.

This method will contact the authorization server to obtain necessary credentials. The JWT token is used for initial authentication and subsequent token renewals.

Arguments

• project_url - The base URL of your Firebase project (e.g., “https://project-id.firebaseio.com”)
• jwt - A valid JWT token for authentication
• api_key - Your Firebase project’s API key

Returns

Returns a Result containing the initialized FirebaseRTDB client or an error

pub fn new_from_token<T: Into<String>, R: Into<String>, V: Into<String>>( project_url: T, api_key: R, jwt: V, auth: AuthResponsePayload, expire_time: Instant, ) -> Result<Self, RtdbError>

Creates a new Firebase RTDB client using an existing valid token.

Use this method when you already have valid authentication credentials and want to avoid an initial token refresh.

Arguments

• project_url - The base URL of your Firebase project
• api_key - Your Firebase project’s API key
• jwt - A valid JWT token
• auth - Existing authentication payload
• expire_time - Token expiration time

pub async fn renew_token(&mut self) -> Result<(), RtdbError>

Renews the authentication token.

This method should be called when the current token is about to expire or has expired. It will update the internal authentication state with new credentials.

pub fn token_expired(&self) -> bool

Checks if the current authentication token has expired.

Returns true if the token has expired and needs to be renewed before making further database requests.

pub async fn root(&mut self) -> Result<Node<'_>, RtdbError>

Returns a Node representing the root of the database.

This method will automatically renew the token if it has expired. Use this as the starting point for accessing database paths.

Trait Implementations

impl Clone for FirebaseRTDB

fn clone(&self) -> FirebaseRTDB

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FirebaseRTDB

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.