Struct WebSubSubscriber 

pub struct WebSubSubscriber {
    pub callback_url: String,
    pub secret: Option<String>,
}

Builds subscription requests and handles incoming WebSub callbacks.

Fields

callback_url: String

The callback URL this subscriber exposes.

secret: Option<String>

Optional HMAC-SHA256 secret for signature verification.

Implementations

impl WebSubSubscriber

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

Create a subscriber with the given callback URL and no secret.

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

Attach an HMAC secret (builder style).

pub fn subscribe_params( &self, hub_url: &str, topic_url: &str, lease_seconds: u64, ) -> Vec<(String, String)>

Return the form-encoded parameters for a subscribe request.

pub fn unsubscribe_params( &self, hub_url: &str, topic_url: &str, ) -> Vec<(String, String)>

Return the form-encoded parameters for an unsubscribe request.

pub fn verify_intent( &self, mode: &str, topic: &str, challenge: &str, _lease_seconds: Option<u64>, ) -> Result<String>

Handle the hub’s intent-verification GET request.

The WebSub spec requires the subscriber to echo back the challenge when it agrees with the mode and topic. Returns Ok(challenge).

pub fn verify_signature( &self, body: &[u8], signature_header: &str, ) -> Result<bool>

Verify the X-Hub-Signature header on an incoming notification.

The header format is sha256=<hex-digest>. Returns Ok(true) on success, Ok(false) if the signature does not match, and Err when no secret is configured or the header is malformed.

pub fn compute_signature(&self, body: &[u8]) -> Result<String>

Compute the X-Hub-Signature header value for a notification body.

Useful for hub implementations that need to sign outgoing content.

Trait Implementations

impl Clone for WebSubSubscriber

fn clone(&self) -> WebSubSubscriber

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WebSubSubscriber

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

Formats the value using the given formatter.