🚧 process test alert

server/private/lib/alerts/processTestAlerts.ts

@@ -0,0 +1,22 @@
+import logger from "@server/logger";
+import type { TestAlertContext } from "@server/routers/alertRule/types";
+import { sendAlertEmail } from "./sendAlertEmail";
+
+export async function processTestAlerts(context: TestAlertContext) {
+    const emailActions = context.actions.filter(
+        (action) => action.type === "email"
+    );
+    // Process email actions
+    for (const action of emailActions) {
+        try {
+            const recipients = await resolveEmailRecipients(
+                action.emailActionId
+            );
+            if (recipients.length > 0) {
+                await sendAlertEmail(recipients, context);
+            }
+        } catch (err) {
+            logger.error(`processAlerts: failed to send alert email`, err);
+        }
+    }
+}

server/private/routers/alertRule/index.ts

@@ -16,4 +16,4 @@ export * from "./updateAlertRule";
 export * from "./deleteAlertRule";
 export * from "./listAlertRules";
 export * from "./getAlertRule";
-export * from "./testSiteAlertRule";
+export * from "./testAlertRule";

server/private/routers/alertRule/testAlertRule.ts

@@ -33,11 +33,44 @@ const paramsSchema = z.strictObject({
     orgId: z.string().nonempty()
 });
 
-const querySchema = z.strictObject({
+export const SITE_EVENT_TYPES = [
-    event: z.enum(["site_offline", "site_online", "site_toggle"])
+    "site_online",
+    "site_offline",
+    "site_toggle"
+] as const;
+export const HC_EVENT_TYPES = [
+    "health_check_healthy",
+    "health_check_unhealthy",
+    "health_check_toggle"
+] as const;
+export const RESOURCE_EVENT_TYPES = [
+    "resource_healthy",
+    "resource_unhealthy",
+    "resource_degraded",
+    "resource_toggle"
+] as const;
+
+const webhookActionSchema = z.strictObject({
+    webhookUrl: z.string().url(),
+    config: z.string().optional(),
+    enabled: z.boolean().optional().default(true)
 });
 
-export async function testSiteAlertRule(
+const bodySchema = z.strictObject({
+    eventType: z.enum([
+        ...HC_EVENT_TYPES,
+        ...SITE_EVENT_TYPES,
+        ...RESOURCE_EVENT_TYPES
+    ]),
+    // Email recipients (flat)
+    userIds: z.array(z.string().nonempty()).optional().default([]),
+    roleIds: z.array(z.number()).optional().default([]),
+    emails: z.array(z.email()).optional().default([]),
+    // Webhook actions
+    webhookActions: z.array(webhookActionSchema).optional().default([])
+});
+
+export async function testAlertRule(
     req: Request,
     res: Response,
     next: NextFunction
@@ -54,16 +87,17 @@ export async function testSiteAlertRule(
         }
         const { orgId } = parsedParams.data;
 
-        const parsedQuery = querySchema.safeParse(req.query);
+        const parsedBody = bodySchema.safeParse(req.body);
-        if (!parsedQuery.success) {
+        if (!parsedBody.success) {
             return next(
                 createHttpError(
                     HttpCode.BAD_REQUEST,
-                    fromError(parsedQuery.error).toString()
+                    fromError(parsedBody.error).toString()
                 )
             );
         }
-        const { event } = parsedQuery.data;
+
+        // TODO: process alert rule
     } catch (error) {
         logger.error(error);
         return next(

server/private/routers/external.ts

@@ -808,12 +808,12 @@ authenticated.get(
     alertRule.listAlertRules
 );
 
-authenticated.get(
+authenticated.post(
-    "/org/:orgId/test-site-alert-rule/:alertRuleId",
+    "/org/:orgId/alert-rule/test",
     verifyValidLicense,
     verifyOrgAccess,
     verifyUserHasAction(ActionsEnum.testAlertRule),
-    alertRule.testSiteAlertRule
+    alertRule.testAlertRule
 );
 
 authenticated.get(

server/routers/alertRule/types.ts

@@ -124,3 +124,25 @@ export interface AlertContext {
     /** Human-readable context data included in emails and webhook payloads */
     data: Record<string, unknown>;
 }
+
+type EmailAlertAction = {
+    type: "email";
+    userIds?: string[];
+    roleIds?: string[];
+    emails?: string[];
+};
+
+type WebhookAlertAction = {
+    type: "webhook";
+    webhookUrl: string;
+    enabled: boolean;
+    config?: string | undefined;
+};
+
+type AlertAction = EmailAlertAction | WebhookAlertAction;
+export interface TestAlertContext {
+    eventType: AlertEventType;
+    actions: AlertAction[];
+    /** Human-readable context data included in emails and webhook payloads */
+    data: Record<string, unknown>;
+}