@checkstack/signal-backend 0.1.20 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @checkstack/signal-backend
 
+## 0.2.1
+
+### Patch Changes
+
+- Updated dependencies [32d52c6]
+- Updated dependencies [32d52c6]
+- Updated dependencies [32d52c6]
+  - @checkstack/backend-api@0.14.0
+
+## 0.2.0
+
+### Minor Changes
+
+- 208ad71: Centralize realtime cache invalidation: signals now carry their owning `pluginId` end-to-end, and a single `SignalAutoInvalidator` mounted near the React Query client invalidates `[[pluginId]]` for every incoming signal automatically.
+
+  **Breaking change to `createSignal`** (`@checkstack/signal-common`): the factory now takes a single object argument with `pluginMetadata`, `event`, and `payloadSchema`. The signal id is constructed as `${pluginMetadata.pluginId}.${event}` and the resulting `Signal` carries a `pluginId` field. The `SignalMessage` wire envelope and `ServerToClientMessage` `signal` variant gained a `pluginId` field so the frontend can route invalidations without parsing the id.
+
+  ```ts
+  // Before
+  export const ANOMALY_STATE_CHANGED = createSignal(
+    "anomaly.state_changed",
+    z.object({ ... }),
+  );
+
+  // After
+  export const ANOMALY_STATE_CHANGED = createSignal({
+    pluginMetadata,
+    event: "state_changed",
+    payloadSchema: z.object({ ... }),
+  });
+  ```
+
+  **New plugin field**: `FrontendPlugin.foreignSignals?: Signal<unknown>[]` lets a plugin opt its `[[pluginId]]` cache into invalidation when another plugin's signal fires (e.g. `dependency-frontend` declares `[SYSTEM_STATUS_CHANGED]` because dependency payloads embed system status). Same-plugin signals must NOT be listed — they are always auto-invalidated.
+
+  **Removed boilerplate**: per-component `useSignal(X, () => refetch())` and `useSignal(X, () => queryClient.invalidateQueries(...))` calls have been removed across `incident-frontend`, `maintenance-frontend`, `healthcheck-frontend`, `slo-frontend`, `dependency-frontend`, `satellite-frontend`, `announcement-frontend`, `notification-frontend`, and `dashboard-frontend`. The `NotificationBell` unread count is now derived directly from the `getUnreadCount` query (auto-invalidated) instead of a local state mirror.
+
+  **User-visible bug fix**: the system detail page anomaly widget (`SystemAnomalyWidget`) now updates in real-time when anomalies change, with no per-widget signal subscription required. The dashboard status page also stays fresh on `ANOMALY_STATE_CHANGED`, `ANOMALY_BASELINE_UPDATED`, and `ANOMALY_TREND_DETECTED`.
+
+  UI-state consumers that legitimately need a `useSignal` (the dashboard activity terminal, the queue lag alert, and the rolling-preset date refresh in `useHealthCheckData`) keep their handlers; the auto-invalidator runs alongside them.
+
+### Patch Changes
+
+- Updated dependencies [208ad71]
+  - @checkstack/signal-common@0.2.0
+  - @checkstack/backend-api@0.13.1
+
 ## 0.1.20
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/signal-backend",
-  "version": "0.1.20",
+  "version": "0.2.1",
   "type": "module",
   "exports": {
     ".": {
@@ -8,9 +8,9 @@
     }
   },
   "dependencies": {
-    "@checkstack/common": "0.6.5",
-    "@checkstack/signal-common": "0.1.9",
-    "@checkstack/backend-api": "0.12.0"
+    "@checkstack/common": "0.7.0",
+    "@checkstack/signal-common": "0.2.0",
+    "@checkstack/backend-api": "0.13.1"
   },
   "devDependencies": {
     "@types/bun": "latest",

package/src/signal-service-impl.test.ts

@@ -6,15 +6,19 @@ import { z } from "zod";
 import type { EventBus, Logger } from "@checkstack/backend-api";
 
 // Test signals
-const TEST_BROADCAST_SIGNAL = createSignal(
-  "test.broadcast",
-  z.object({ message: z.string() })
-);
+const testPluginMetadata = { pluginId: "test" };
 
-const TEST_USER_SIGNAL = createSignal(
-  "test.user",
-  z.object({ notification: z.string(), count: z.number() })
-);
+const TEST_BROADCAST_SIGNAL = createSignal({
+  pluginMetadata: testPluginMetadata,
+  event: "broadcast",
+  payloadSchema: z.object({ message: z.string() }),
+});
+
+const TEST_USER_SIGNAL = createSignal({
+  pluginMetadata: testPluginMetadata,
+  event: "user",
+  payloadSchema: z.object({ notification: z.string(), count: z.number() }),
+});
 
 describe("SignalServiceImpl", () => {
   let signalService: SignalServiceImpl;
@@ -55,10 +59,12 @@ describe("SignalServiceImpl", () => {
 
       const message = emittedEvents[0].payload as {
         signalId: string;
+        pluginId: string;
         payload: typeof payload;
         timestamp: string;
       };
       expect(message.signalId).toBe("test.broadcast");
+      expect(message.pluginId).toBe("test");
       expect(message.payload).toEqual(payload);
       expect(typeof message.timestamp).toBe("string");
     });
@@ -96,10 +102,15 @@ describe("SignalServiceImpl", () => {
 
       const emitted = emittedEvents[0].payload as {
         userId: string;
-        message: { signalId: string; payload: typeof payload };
+        message: {
+          signalId: string;
+          pluginId: string;
+          payload: typeof payload;
+        };
       };
       expect(emitted.userId).toBe(userId);
       expect(emitted.message.signalId).toBe("test.user");
+      expect(emitted.message.pluginId).toBe("test");
       expect(emitted.message.payload).toEqual(payload);
     });
 

package/src/signal-service-impl.ts

@@ -40,6 +40,7 @@ export class SignalServiceImpl implements SignalService {
   async broadcast<T>(signal: Signal<T>, payload: T): Promise<void> {
     const message: SignalMessage<T> = {
       signalId: signal.id,
+      pluginId: signal.pluginId,
       payload,
       timestamp: new Date().toISOString(),
     };
@@ -57,6 +58,7 @@ export class SignalServiceImpl implements SignalService {
   ): Promise<void> {
     const message: SignalMessage<T> = {
       signalId: signal.id,
+      pluginId: signal.pluginId,
       payload,
       timestamp: new Date().toISOString(),
     };

package/src/websocket-handler.test.ts

@@ -296,6 +296,7 @@ describe("createWebSocketHandler", () => {
 
       await broadcastSubscription!.handler({
         signalId: "test.signal",
+        pluginId: "test",
         payload: { data: "test" },
         timestamp: new Date().toISOString(),
       });
@@ -306,6 +307,7 @@ describe("createWebSocketHandler", () => {
       const parsed = JSON.parse(publishedMessage!);
       expect(parsed.type).toBe("signal");
       expect(parsed.signalId).toBe("test.signal");
+      expect(parsed.pluginId).toBe("test");
     });
 
     it("should publish user signals to user-specific channel", async () => {
@@ -336,6 +338,7 @@ describe("createWebSocketHandler", () => {
         userId: "target-user",
         message: {
           signalId: "notification.received",
+          pluginId: "notification",
           payload: { id: "n-1" },
           timestamp: new Date().toISOString(),
         },
@@ -347,6 +350,7 @@ describe("createWebSocketHandler", () => {
       const parsed = JSON.parse(publishedMessage!);
       expect(parsed.type).toBe("signal");
       expect(parsed.signalId).toBe("notification.received");
+      expect(parsed.pluginId).toBe("notification");
     });
   });
 });

package/src/websocket-handler.ts

@@ -86,6 +86,7 @@ export function createWebSocketHandler(
         const payload: ServerToClientMessage = {
           type: "signal",
           signalId: message.signalId,
+          pluginId: message.pluginId,
           payload: message.payload,
           timestamp: message.timestamp,
         };
@@ -103,6 +104,7 @@ export function createWebSocketHandler(
         const payload: ServerToClientMessage = {
           type: "signal",
           signalId: message.signalId,
+          pluginId: message.pluginId,
           payload: message.payload,
           timestamp: message.timestamp,
         };