Struct AuthClient 

pub struct AuthClient { /* private fields */ }

Authentication client for interacting with Brainwires Studio backend

Unlike the CLI version, this client does NOT auto-save sessions or manage keyring storage. The caller is responsible for persisting the auth response.

Implementations

impl AuthClient

pub fn new( backend_url: String, auth_endpoint: String, api_key_pattern: &str, ) -> Self

Create a new authentication client

Arguments

• backend_url - Base URL (e.g., https://brainwires.studio)
• auth_endpoint - Auth endpoint path (e.g., “/api/cli/auth”)
• api_key_pattern - Regex pattern for API key validation (e.g., r“^bw_(prod|dev|test)_[a-z0-9]{32}$“)

pub fn from_endpoints(endpoints: &dyn AuthEndpoints) -> Self

Create from an AuthEndpoints trait implementation

pub fn validate_api_key_format(&self, api_key: &str) -> Result<()>

Validate API key format against the configured pattern

pub async fn authenticate(&self, api_key: &str) -> Result<AuthResponse>

Authenticate with API key

Returns the raw AuthResponse from the backend. The caller is responsible for creating a session and storing the API key.

pub fn backend_url(&self) -> &str

Get the configured backend URL