webhook-architecture

Establishes layered NestJS webhook handling with signature verification, deduplication, and routing.

28|6|Updated Aug 31, 2025
One-click install
npx skills add https://github.com/Hive-Academy/ptah-extension --skill webhook-architecture-hive-academy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: webhook-architecture
Source: https://github.com/Hive-Academy/ptah-extension/tree/main/apps/ptah-extension-vscode/assets/plugins/ptah-nx-saas/skills/webhook-architecture
Command: npx skills add https://github.com/Hive-Academy/ptah-extension --skill webhook-architecture-hive-academy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

It provides a structured, secure, and resilient approach to handling inbound webhooks in NestJS applications, ensuring reliable processing and easy maintenance.

Core Features & Use Cases

  • Layered Separation: Distinguishes HTTP concerns, verification, routing, and business logic for clearer code and better security.
  • Idempotency & Failure Handling: Implements duplicate detection and failure storage to prevent repeated processing and enable recovery.
  • Scalable Architecture: Supports high throughput and complex workflows for payment, messaging, CI/CD, and other integrations.
  • Use Case: Automate processing of GitHub Webhooks by verifying signatures, routing events to microservices, and logging failures for audit.

Quick Start

Configure your NestJS main.ts with raw body parsing and set up a webhook controller that delegates to a verification and routing service.

Frequently Asked Questions about webhook-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle webhook signature verification and deduplication in NestJS?

Webhook signature verification and deduplication in NestJS are handled using a multi-layer pattern that separates HTTP concerns, verification routing, and business logic to ensure secure, resilient processing.

What is the best way to structure webhook controllers for high throughput in NestJS?

The best way to structure webhook controllers for high throughput in NestJS is a scalable architecture that distinguishes HTTP reception, verification, and routing, enabling seamless complex workflow support for payment and messaging integrations.

How do I prevent duplicate webhook processing and store failures for audit in NestJS?

Prevent duplicate webhook processing and store failures for audit in NestJS by implementing idempotency and failure handling mechanisms that detect duplicates and log failures for subsequent recovery and review.

Does this webhook pattern work for GitHub, payment, and infrastructure webhooks in NestJS?

Yes, this webhook pattern works for GitHub, payment, and infrastructure webhooks in NestJS, applying a layered separation approach to verify signatures, route events to microservices, and log failures across diverse integrations.

Why do I need raw body parsing configured in main.ts for NestJS webhook signature verification?

Raw body parsing configured in main.ts for NestJS webhook signature verification is needed to accurately validate the incoming payload signature before the framework transforms the HTTP request body.