Struct CorsConfig 

#[non_exhaustive]
pub struct CorsConfig {
    pub allow_origin: String,
    pub allow_methods: String,
    pub allow_headers: String,
    pub max_age_secs: u32,
}

CORS configuration for A2A dispatchers.

Examples

use a2a_protocol_server::dispatch::cors::CorsConfig;

// Allow all origins (development/testing).
let cors = CorsConfig::permissive();

// Restrict to a specific origin.
let cors = CorsConfig::new("https://my-app.example.com");

#[non_exhaustive]: build it with CorsConfig::new or CorsConfig::permissive and the with_* setters, which cover every field; a struct literal is not available outside this crate, so a field added later does not break callers.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

allow_origin: String

The Access-Control-Allow-Origin value.

allow_methods: String

The Access-Control-Allow-Methods value.

allow_headers: String

The Access-Control-Allow-Headers value.

max_age_secs: u32

The Access-Control-Max-Age value in seconds.

Implementations

impl CorsConfig

pub fn new(allow_origin: impl Into<String>) -> Self

Creates a new CorsConfig with the given allowed origin.

pub fn permissive() -> Self

Creates a permissive CorsConfig that allows all origins.

Suitable for development or public APIs. For production use, prefer CorsConfig::new with a specific origin.

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

Sets the Access-Control-Allow-Origin value.

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

Sets the Access-Control-Allow-Methods value.

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

Sets the Access-Control-Allow-Headers value, replacing the default list — include content-type, a2a-version and whatever your clients send, or their preflight fails.

pub const fn with_max_age_secs(self, secs: u32) -> Self

Sets the Access-Control-Max-Age value in seconds.

pub fn apply_headers<B>(&self, resp: &mut Response<B>)

Applies CORS headers to an existing HTTP response.

pub fn preflight_response(&self) -> Response<BoxBody<Bytes, Infallible>>

Builds a preflight (OPTIONS) response with CORS headers.

Trait Implementations

impl Clone for CorsConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CorsConfig

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

Formats the value using the given formatter.