@checkstack/notification-discord-backend 0.1.21 → 0.1.23

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @checkstack/notification-discord-backend
 
+## 0.1.23
+
+### Patch Changes
+
+- 32d52c6: Bulk notifications affecting multiple systems and collapse lifecycle events into a single card.
+
+  Notifications now carry an optional `subjects` array (the entities they affect) and an optional `collapseKey` (so related notifications collapse into one row per recipient). Incidents, maintenances, anomalies, healthchecks, and dependency-impact events route through these new fields, so an incident affecting three systems produces one in-app notification + one external send per subscriber instead of three. Lifecycle updates for the same entity (created → updated → resolved) also collapse, with an expandable "+N updates" timeline.
+
+  Subject kinds are namespaced as `<pluginId>.<localKind>` and built via type-safe helpers exported from each domain's common package (`createSystemSubject`, `incidentCollapseKey`, etc.). The frontend kind registry (`registerSubjectKind`) lets plugins bind icon + label for their kinds; unknown kinds fall back to a generic chip.
+
+  All notification strategies (SMTP, Slack, Discord, Teams, Telegram, Pushover, Gotify, Webex, Backstage) render the affected subjects natively in their format (HTML cards, Slack blocks, Discord embed fields, adaptive cards, markdown lists, etc.).
+
+- Updated dependencies [32d52c6]
+- Updated dependencies [32d52c6]
+- Updated dependencies [32d52c6]
+- Updated dependencies [32d52c6]
+  - @checkstack/notification-backend@1.0.0
+  - @checkstack/backend-api@0.14.0
+
+## 0.1.22
+
+### Patch Changes
+
+- @checkstack/backend-api@0.13.1
+- @checkstack/notification-backend@0.2.1
+
 ## 0.1.21
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/notification-discord-backend",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "type": "module",
   "main": "src/index.ts",
   "checkstack": {
@@ -16,9 +16,9 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@checkstack/backend-api": "0.12.0",
-    "@checkstack/common": "0.6.5",
-    "@checkstack/notification-backend": "0.1.23",
+    "@checkstack/backend-api": "0.13.1",
+    "@checkstack/common": "0.7.0",
+    "@checkstack/notification-backend": "0.2.1",
     "zod": "^4.2.1"
   },
   "devDependencies": {

package/src/index.ts

@@ -6,6 +6,7 @@ import {
   type NotificationStrategy,
   type NotificationSendContext,
   type NotificationDeliveryResult,
+  type NotificationSubject,
   markdownToPlainText,
 } from "@checkstack/backend-api";
 import { notificationStrategyExtensionPoint } from "@checkstack/notification-backend";
@@ -67,6 +68,7 @@ interface DiscordEmbedOptions {
   body?: string;
   importance: "info" | "warning" | "critical";
   action?: { label: string; url: string };
+  subjects?: NotificationSubject[];
 }
 
 interface DiscordEmbed {
@@ -77,8 +79,15 @@ interface DiscordEmbed {
   timestamp?: string;
 }
 
+const SUBJECT_STATUS_EMOJI = {
+  healthy: "🟢",
+  degraded: "🟡",
+  unhealthy: "🔴",
+  unknown: "⚪",
+} as const;
+
 function buildDiscordEmbed(options: DiscordEmbedOptions): DiscordEmbed {
-  const { title, body, importance, action } = options;
+  const { title, body, importance, action, subjects } = options;
 
   // Discord colors are decimal values
   const importanceColors: Record<string, number> = {
@@ -104,14 +113,38 @@ function buildDiscordEmbed(options: DiscordEmbedOptions): DiscordEmbed {
     embed.description = markdownToPlainText(body);
   }
 
+  const fields: NonNullable<DiscordEmbed["fields"]> = [];
+
+  if (subjects && subjects.length > 0) {
+    // One field summarizing every affected subject as a markdown bullet
+    // list. Discord renders [name](url) in field values, and prefixes
+    // status with a colored circle when present.
+    fields.push({
+      name: "Affected",
+      value: subjects
+        .map((subject) => {
+          const prefix = subject.status
+            ? `${SUBJECT_STATUS_EMOJI[subject.status]} `
+            : "• ";
+          return subject.url
+            ? `${prefix}[${subject.name}](${subject.url})`
+            : `${prefix}${subject.name}`;
+        })
+        .join("\n"),
+      inline: false,
+    });
+  }
+
   if (action?.url) {
-    embed.fields = [
-      {
-        name: action.label,
-        value: `[Click here](${action.url})`,
-        inline: false,
-      },
-    ];
+    fields.push({
+      name: action.label,
+      value: `[Click here](${action.url})`,
+      inline: false,
+    });
+  }
+
+  if (fields.length > 0) {
+    embed.fields = fields;
   }
 
   return embed;
@@ -166,6 +199,7 @@ const discordStrategy: NotificationStrategy<DiscordConfig, DiscordUserConfig> =
           body: notification.body,
           importance: notification.importance,
           action: notification.action,
+          subjects: notification.subjects,
         });
 
         // Send to Discord webhook