Struct WebhookTrigger 

pub struct WebhookTrigger {
    pub path: String,
    pub secret: Option<String>,
    pub required_fields: HashMap<String, String>,
    pub description: String,
}

Configuration for an HTTP POST webhook trigger.

When an HTTP POST arrives at path, the JSON body is decoded and checked:

1. If secret is set, the X-Hub-Signature-256 header must contain a valid HMAC-SHA256 signature of the raw body (pure-Rust implementation).
2. All entries in required_fields must be present in the JSON object with the expected string values.

Real HTTP integration is the caller’s responsibility; see WebhookRouter.

Fields

path: String

URL path that activates this trigger (e.g. "/webhooks/ingest-ready").

secret: Option<String>

Optional HMAC-SHA256 secret for signature verification.

required_fields: HashMap<String, String>

JSON body fields that must match to fire the trigger.

description: String

Optional description.

Implementations

impl WebhookTrigger

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

Create a new webhook trigger for the given path.

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

Set an HMAC-SHA256 secret for signature verification.

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

Require a JSON body field to have a specific value.

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

Set a human-readable description.

pub fn verify_signature(&self, payload: &[u8], signature: &str) -> bool

Verify the HMAC-SHA256 signature of a raw payload.

signature is the hex-encoded digest (e.g. the value of the X-Hub-Signature-256 header without any sha256= prefix).

Returns true when the signature is valid or no secret is configured.

pub fn body_matches(&self, body: &Value) -> bool

Check whether a parsed JSON body satisfies the required-fields filter.

Trait Implementations

impl Clone for WebhookTrigger

fn clone(&self) -> WebhookTrigger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for WebhookTrigger

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

Formats the value using the given formatter.