feat: add event filtering capability for notifications

- Introduced a new environment variable, FILTER_EVENTS, to specify which event types should trigger notifications.
- Updated the webhook processing logic to filter events based on the specified types.
- Enhanced documentation to include instructions for setting up event filtering.

Author: kWAYTV

apps/fumadocs/content/docs/installation/environment.mdx

@@ -100,6 +100,25 @@ Add the variables for at least one provider. See the [Providers](/docs/providers
 </Step>
 <Step>
 
+### Add Event Filtering (Optional)
+
+<TypeTable
+  type={{
+    FILTER_EVENTS: {
+      description: 'Comma-separated list of event types to allow',
+      type: 'string',
+      default: 'all events',
+    },
+  }}
+/>
+
+Example: `FILTER_EVENTS=deployment.error,deployment.succeeded,deployment.ready`
+
+If set, only the specified events will trigger notifications. If not set, all events pass through.
+
+</Step>
+<Step>
+
 ### Redeploy
 
 Go to **Deployments** and click the three dots on the latest deployment →

apps/web/src/app/api/hook/route.ts

@@ -2,6 +2,7 @@ import { after } from "next/server";
 import { ZodError } from "zod/v4";
 
 import HttpStatusCode from "@/enums/http-status-codes";
+import { isEventAllowed } from "@/lib/filter";
 import { sendNotifications } from "@/lib/notify";
 import { checkRateLimit, getClientIp } from "@/lib/ratelimit";
 import { verifySignature } from "@/lib/verify";
@@ -33,6 +34,10 @@ export async function POST(req: Request) {
     const payload = JSON.parse(rawBody) as unknown;
     const webhook = webhookSchema.parse(payload);
 
+    if (!isEventAllowed(webhook.type)) {
+      return Response.json({ success: true, message: "Event filtered" });
+    }
+
     after(() => sendNotifications(webhook));
 
     return Response.json({ success: true, message: "Webhook processed" });

apps/web/src/env.ts

@@ -15,6 +15,8 @@ export const env = createEnv({
     // Rate limiting
     UPSTASH_REDIS_REST_URL: string().url().optional(),
     UPSTASH_REDIS_REST_TOKEN: string().optional(),
+    // Filtering
+    FILTER_EVENTS: string().optional(),
   },
   client: {},
   runtimeEnv: {
@@ -25,6 +27,7 @@ export const env = createEnv({
     SLACK_WEBHOOK_URL: process.env.SLACK_WEBHOOK_URL,
     UPSTASH_REDIS_REST_URL: process.env.UPSTASH_REDIS_REST_URL,
     UPSTASH_REDIS_REST_TOKEN: process.env.UPSTASH_REDIS_REST_TOKEN,
+    FILTER_EVENTS: process.env.FILTER_EVENTS,
   },
   extends: [vercel()],
 });

apps/web/src/lib/filter.ts

@@ -0,0 +1,18 @@
+import { env } from "@/env";
+import type { WebhookType } from "@/schemas/vercel";
+
+const allowedEvents: Set<string> | null = env.FILTER_EVENTS
+  ? new Set(env.FILTER_EVENTS.split(",").map((e) => e.trim()))
+  : null;
+
+/**
+ * Check if an event type should trigger notifications.
+ * If FILTER_EVENTS is not set, all events are allowed.
+ * If set, only events in the comma-separated list are allowed.
+ */
+export function isEventAllowed(type: WebhookType): boolean {
+  if (!allowedEvents) {
+    return true;
+  }
+  return allowedEvents.has(type);
+}

turbo.json

@@ -13,6 +13,7 @@
         "SLACK_WEBHOOK_URL",
         "UPSTASH_REDIS_REST_TOKEN",
         "UPSTASH_REDIS_REST_URL",
+        "FILTER_EVENTS",
         "WEBHOOK_INTEGRATION_SECRET"
       ]
     },