1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
//! Webhook server module for handling GitHub webhook events
//!
//! This module provides the HTTP server implementation for receiving and processing
//! GitHub webhook events. It includes HMAC verification, event routing, and handler
//! execution.
//!
//! # Key Components
//!
//! - [`WebhookServer`] - HTTP server for receiving webhook events
//! - [`AppState`] - Shared application state containing handlers and GitHub client
//! - [`handlers`] - Request handlers for webhook and health check endpoints
//!
//! # Architecture
//!
//! The webhook server uses Axum for HTTP handling with the following flow:
//!
//! 1. **HMAC Verification** - Validates webhook authenticity using shared secret
//! 2. **Event Processing** - Extracts GitHub event information from headers
//! 3. **Handler Routing** - Routes events to registered handlers based on event type
//! 4. **Context Creation** - Creates Context with event data and GitHub client
//! 5. **Handler Execution** - Executes all registered handlers for the event type
//!
//! # Examples
//!
//! ## Basic Server Setup
//!
//! ```rust,no_run
//! use octofer::{Config, webhook::WebhookServer};
//!
//! # async fn example() -> anyhow::Result<()> {
//! let config = Config::from_env()?;
//! let server = WebhookServer::new(
//! config.server.host,
//! config.server.port,
//! config.github.clone(),
//! &config.webhook.secret,
//! &config.webhook.header_name,
//! ).await?;
//!
//! // Server is ready to receive webhooks
//! server.start().await?;
//! # Ok(())
//! # }
//! ```
pub use *;