Struct ClientConfigBuilder 

pub struct ClientConfigBuilder { /* private fields */ }

Builder for creating ClientConfig instances with fluent API.

Reduces cognitive load when registering OAuth clients with many optional fields. Required fields are set in new(), optional fields via builder methods.

Example

use auth_framework::client::{ClientConfig, ClientType};
use auth_framework::types::{RedirectUris, Scopes, GrantTypes, ResponseTypes};

let config = ClientConfig::builder("client123", ClientType::Confidential)
    .client_secret("secret456")
    .redirect_uris(RedirectUris::new(vec!["https://example.com/callback".to_string()]))
    .authorized_scopes(Scopes::new(vec!["read".to_string(), "write".to_string()]))
    .client_name("My App")
    .build();

Implementations

impl ClientConfigBuilder

pub fn new(client_id: impl Into<String>, client_type: ClientType) -> Self

Create a new builder with required fields.

Sets sensible defaults for optional fields:

• client_secret: None
• redirect_uris: empty
• authorized_scopes: [“read”]
• authorized_grant_types: [“authorization_code”]
• authorized_response_types: [“code”]
• client_name, client_description: None
• metadata: empty

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};

let builder = ClientConfigBuilder::new("my-app", ClientType::Public);
let config = builder.build();
assert_eq!(config.client_id, "my-app");

pub fn client_secret(self, client_secret: impl Into<String>) -> Self

Set the client secret.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};

let config = ClientConfigBuilder::new("app", ClientType::Confidential)
    .client_secret("s3cret")
    .build();
assert_eq!(config.client_secret.unwrap(), "s3cret");

pub fn redirect_uris(self, redirect_uris: RedirectUris) -> Self

Set the authorized redirect URIs.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};
use auth_framework::types::RedirectUris;

let config = ClientConfigBuilder::new("app", ClientType::Public)
    .redirect_uris(RedirectUris::new(vec!["https://example.com/cb".into()]))
    .build();

pub fn authorized_scopes(self, authorized_scopes: Scopes) -> Self

Set the authorized scopes.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};
use auth_framework::types::Scopes;

let config = ClientConfigBuilder::new("app", ClientType::Public)
    .authorized_scopes(Scopes::new(vec!["read".into(), "write".into()]))
    .build();

pub fn authorized_grant_types(self, authorized_grant_types: GrantTypes) -> Self

Set the authorized grant types.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};
use auth_framework::types::GrantTypes;

let config = ClientConfigBuilder::new("app", ClientType::Confidential)
    .authorized_grant_types(GrantTypes::new(vec!["client_credentials".into()]))
    .build();

pub fn authorized_response_types( self, authorized_response_types: ResponseTypes, ) -> Self

Set the authorized response types.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};
use auth_framework::types::ResponseTypes;

let config = ClientConfigBuilder::new("app", ClientType::Public)
    .authorized_response_types(ResponseTypes::new(vec!["code".into()]))
    .build();

pub fn client_name(self, client_name: impl Into<String>) -> Self

Set the client name.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};

let config = ClientConfigBuilder::new("app", ClientType::Public)
    .client_name("My Application")
    .build();
assert_eq!(config.client_name.unwrap(), "My Application");

pub fn client_description(self, client_description: impl Into<String>) -> Self

Set the client description.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};

let config = ClientConfigBuilder::new("app", ClientType::Public)
    .client_description("OAuth 2.0 demo app")
    .build();
assert_eq!(config.client_description.unwrap(), "OAuth 2.0 demo app");

pub fn metadata(self, metadata: HashMap<String, Value>) -> Self

Set the metadata.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};
use std::collections::HashMap;

let mut meta = HashMap::new();
meta.insert("logo_uri".into(), serde_json::json!("https://example.com/logo.png"));
let config = ClientConfigBuilder::new("app", ClientType::Public)
    .metadata(meta)
    .build();
assert!(config.metadata.contains_key("logo_uri"));

pub fn with_metadata(self, key: impl Into<String>, value: Value) -> Self

Add a metadata key-value pair.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};

let config = ClientConfigBuilder::new("app", ClientType::Public)
    .with_metadata("tos_uri", serde_json::json!("https://example.com/tos"))
    .build();
assert!(config.metadata.contains_key("tos_uri"));

pub fn build(self) -> ClientConfig

Build the ClientConfig instance.

Example

use auth_framework::client::{ClientConfigBuilder, ClientType};

let config = ClientConfigBuilder::new("app", ClientType::Public).build();
assert_eq!(config.client_id, "app");

Trait Implementations

impl Clone for ClientConfigBuilder

fn clone(&self) -> ClientConfigBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfigBuilder

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

Formats the value using the given formatter.