@checkstack/catalog-common 1.4.1 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @checkstack/catalog-common
 
+## 1.5.0
+
+### Minor Changes
+
+- 298bf42: ### Notification System Optimizations
+
+  **System context in notifications**: All notification senders (healthcheck, incident, maintenance, dependency) now include the affected system name in the notification title and body. Users can immediately identify which system is affected without clicking through to the detail page.
+
+  **Upstream notification deduplication**: When an upstream dependency goes down affecting multiple downstream systems, the dependency notification sidecar now sends **one personalized notification per user** instead of one notification per affected system. Each user's notification lists only the systems they are subscribed to, with a link to the upstream root cause system. This prevents notification floods for users subscribed to groups containing many dependent systems.
+
+  **New catalog endpoint**: Added `getSystemGroupIds` S2S RPC endpoint on the catalog to resolve which catalog groups contain a given system, used by the dependency plugin for efficient subscriber resolution during batched notification dispatch.
+
 ## 1.4.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/catalog-common",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "type": "module",
   "exports": {
     ".": {
@@ -9,7 +9,7 @@
   },
   "dependencies": {
     "@checkstack/common": "0.6.5",
-    "@checkstack/auth-common": "0.6.1",
+    "@checkstack/auth-common": "0.6.2",
     "@checkstack/frontend-api": "0.3.9",
     "@orpc/contract": "^1.13.14",
     "zod": "^4.2.1"

package/src/rpc-contract.ts

@@ -266,6 +266,19 @@ export const catalogContract = {
       }),
     )
     .output(z.object({ notifiedCount: z.number() })),
+
+  /**
+   * Get the catalog group IDs that contain a specific system.
+   * Returns raw group IDs (not namespaced with notification prefix).
+   * Used by the dependency plugin for batched notification deduplication.
+   */
+  getSystemGroupIds: proc({
+    operationType: "query",
+    userType: "service",
+    access: [],
+  })
+    .input(z.object({ systemId: z.string() }))
+    .output(z.object({ groupIds: z.array(z.string()) })),
 };
 
 // Export contract type