Webhook Handler

Type-safe webhook receiver with signature verification, retry logic, event logging, and dead letter queue. Supports Stripe, GitHub, Slack, and custom webhook sources.

TypeScriptIntegrationsBuilt with Claude

1.3k

Stars

6.8k

Installs

Deps

Comments

Install / Copy

npx create-freestack-module webhook-handler

Code Preview

index.tsx

import { createHmac } from "crypto";

interface WebhookConfig {
  secret: string;
  source: "stripe" | "github" | "slack" | "custom";
  handler: (event: WebhookEvent) => Promise<void>;
  retries?: number;
}

export function createWebhookHandler(config: WebhookConfig) {
  return async function handler(request: Request) {
    const body = await request.text();
    const signature = request.headers.get("x-signature");

    if (!verifySignature(body, signature, config.secret)) {
      return new Response("Invalid signature", { status: 401 });
    }

    const event = JSON.parse(body) as WebhookEvent;
    await logEvent(event);

    try {
      await config.handler(event);
      return new Response("OK", { status: 200 });
    } catch (error) {
      await addToDeadLetterQueue(event, error);
      return new Response("Processing failed", { status: 500 });
    }
  };
}