How proxynth/larawebhook works
LaraWebhook is a Laravel package for receiving and validating provider webhooks, preventing duplicate processing, recording audit logs, and supporting retries, replay, notifications, and log review. The main flow is an incoming request through the receive use case, which coordinates parsing, validation, idempotency checks, and audit recording; Laravel adapters provide persistence and HTTP access. The README documents provider support, payload privacy modes, retention, dashboard/API access, retry, and replay. Some subsystems are represented by their exact source directories because their implementation was not excerpted.
Main entry points: ReceiveWebhook.php Receive webhook · WebhookLogger.php Webhook logger · LarawebhookServiceProvider.php Laravel service provider · RetryWebhook.php Retry use case
Components 22
Webhook ingestion
- Receive webhook
src/Ingestion/Application/UseCases/ReceiveWebhook.php - Validate webhook
src/Ingestion/Application/UseCases/ValidateWebhook.php - Provider validators
src/Ingestion/Infrastructure/Validation - Provider parsers
src/Ingestion/Infrastructure/Parsing
Processing and recovery
- Webhook event state
src/Processing/Domain/Entities/WebhookEvent.php - Idempotency and deduplication
src/Processing/Infrastructure/Idempotency/DefaultIdempotencyResolver.php - Processed event store
src/Processing/Infrastructure/Persistence/EloquentProcessedWebhookRecorder.php - Retry use case
src/Processing/Application/UseCases/RetryWebhook.php - Retry job
src/Processing/Infrastructure/Laravel/Jobs/RetryWebhookJob.php - Replay use case
src/Processing/Application/UseCases/ReplayWebhook.php
Audit and privacy
- Record webhook log
src/Audit/Application/Commands/RecordWebhookLogCommand.php - Webhook logger
src/Audit/Infrastructure/Logging/WebhookLogger.php - Payload privacy
src/Audit/Infrastructure/Payload/PayloadStorageResolver.php - Webhook log store
src/Audit/Infrastructure/Laravel/Persistence/Models/WebhookLog.php - Log queries
src/Shared/Infrastructure/Laravel/Queries/WebhookLogQueries.php - Failure notifications
src/Audit/Infrastructure/Laravel/Notifications/NotificationSender.php - Log retention
src/Audit/Application/UseCases/PruneWebhookLogs.php
Laravel integration
- Dashboard
src/Audit/Infrastructure/Laravel/Http/Controllers/DashboardController.php - Log and replay API
src/Audit/Infrastructure/Laravel/Http/Controllers/WebhookLogController.php - Laravel service provider
src/Shared/Infrastructure/Laravel/Providers/LarawebhookServiceProvider.php
Shared domain
- Service identifiers
src/Shared/Domain/Enums/WebhookService.php
Other components
- Webhook sender
Connections 25
- Webhook sender → Receive webhook: sends request
README.md - Receive webhook → Validate webhook: validates
src/Ingestion/Application/UseCases/ReceiveWebhook.php - Receive webhook → Provider parsers: resolves parser
src/Ingestion/Application/UseCases/ReceiveWebhook.php - Receive webhook → Idempotency and deduplication: resolves key
src/Ingestion/Application/UseCases/ReceiveWebhook.php - Receive webhook → Webhook event state: creates event
src/Ingestion/Application/UseCases/ReceiveWebhook.php - Receive webhook → Processed event store: records processing
src/Ingestion/Application/UseCases/ReceiveWebhook.php - Receive webhook → Record webhook log: records audit log
src/Ingestion/Application/UseCases/ReceiveWebhook.php - Validate webhook → Provider validators: validates signature
- Laravel service provider → Provider validators: registers validators
src/Shared/Infrastructure/Laravel/Providers/LarawebhookServiceProvider.php - Laravel service provider → Provider parsers: registers parsers
src/Shared/Infrastructure/Laravel/Providers/LarawebhookServiceProvider.php - Service identifiers → Provider validators: selects provider
src/Ingestion/Infrastructure/Validation/WebhookValidatorFactory.php - Retry use case → Validate webhook: revalidates
src/Processing/Application/UseCases/RetryWebhook.php - Retry use case → Record webhook log: records attempt
src/Processing/Application/UseCases/RetryWebhook.php - Retry job → Retry use case: dispatches retry
- Replay use case → Webhook event state: replays event
- Log and replay API → Replay use case: requests replay
src/Audit/Infrastructure/Laravel/Http/Controllers/WebhookLogController.php - Record webhook log → Webhook logger: records through
- Webhook logger → Payload privacy: resolves payload
src/Shared/Infrastructure/Laravel/Providers/LarawebhookServiceProvider.php - Webhook logger → Webhook log store: persists logs
- Dashboard → Log queries: reads logs
- Log and replay API → Log queries: queries logs
src/Audit/Infrastructure/Laravel/Http/Controllers/WebhookLogController.php - Log retention → Webhook log store: prunes logs
- Failure notifications → Webhook logger: alerts on failures
- Laravel service provider → Webhook logger: registers logger
src/Shared/Infrastructure/Laravel/Providers/LarawebhookServiceProvider.php - Laravel service provider → Failure notifications: registers notifications
src/Shared/Infrastructure/Laravel/Providers/LarawebhookServiceProvider.php