Struct WebhookUrl 

pub struct WebhookUrl(/* private fields */);

The push-notification URL a client registered, after URL filter approval.

The newtype exists so the wire codec can parse a Url once, hand the filtered value to the use case, and have the type system prove the URL was checked before delivery. A Url that arrives at the delivery port without going through WebhookUrl::new is a delivery path that bypassed the SSRF guard.

Implementations

impl WebhookUrl

pub fn new( filter: &dyn UrlFilter, url: Url, version: A2aVersion, ) -> Result<Self, FilterDenial>

Wraps a URL that has already passed the UrlFilter::check_at_config gate.

Errors

The only thing this constructor can refuse is a URL that the filter would refuse — UrlFilter::check_at_config is the gate, not this constructor, but the constructor delegates the check to the provided filter so the wire codec has one call to make and one error to handle.

pub const fn as_url(&self) -> &Url

The inner URL, for an adapter that has to make the request.

pub fn idempotency_key(&self) -> IdempotencyKey

The key the delivery adapter uses to dedupe retried deliveries.

WebhookUrl::idempotency_key(url) is a pure function of the URL — the same URL produces the same key on every call. The delivery adapter records (key, response) and returns the recorded response on retry, so a network blip that lost the 2xx reply does not produce a duplicate notification.

Trait Implementations

impl Clone for WebhookUrl

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 WebhookUrl

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

Formats the value using the given formatter.