@checkstack/announcement-frontend 0.2.13 → 0.2.14

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @checkstack/announcement-frontend
 
+## 0.2.14
+
+### Patch 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.
+
+- Updated dependencies [208ad71]
+  - @checkstack/signal-frontend@0.1.0
+  - @checkstack/frontend-api@0.4.0
+  - @checkstack/announcement-common@0.3.0
+  - @checkstack/auth-frontend@0.5.31
+  - @checkstack/ui@1.6.1
+
 ## 0.2.13
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/announcement-frontend",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "type": "module",
   "main": "src/index.tsx",
   "checkstack": {
@@ -12,12 +12,12 @@
     "lint:code": "eslint . --max-warnings 0"
   },
   "dependencies": {
-    "@checkstack/announcement-common": "0.2.1",
-    "@checkstack/auth-frontend": "0.5.29",
-    "@checkstack/common": "0.6.5",
-    "@checkstack/frontend-api": "0.3.10",
-    "@checkstack/signal-frontend": "0.0.15",
-    "@checkstack/ui": "1.5.1",
+    "@checkstack/announcement-common": "0.2.2",
+    "@checkstack/auth-frontend": "0.5.30",
+    "@checkstack/common": "0.7.0",
+    "@checkstack/frontend-api": "0.3.11",
+    "@checkstack/signal-frontend": "0.0.16",
+    "@checkstack/ui": "1.6.0",
     "date-fns": "^4.1.0",
     "lucide-react": "^0.344.0",
     "react": "^18.2.0",

package/src/components/AnnouncementBanner.tsx

@@ -2,10 +2,8 @@ import React, { useState, useCallback } from "react";
 import { usePluginClient } from "@checkstack/frontend-api";
 import {
   AnnouncementApi,
-  ANNOUNCEMENT_UPDATED,
   type Announcement,
 } from "@checkstack/announcement-common";
-import { useSignal } from "@checkstack/signal-frontend";
 import { MarkdownBlock } from "@checkstack/ui";
 import {
   Info,
@@ -183,15 +181,7 @@ export const AnnouncementBanner: React.FC = () => {
     getLocalDismissedIds(),
   );
 
-  const { data, isLoading, refetch } =
-    announcementClient.getActiveAnnouncements.useQuery();
-
-  // Refetch own query immediately + invalidate all announcement queries
-  // (including the dashboard's includeDismissed variant) for cross-component freshness.
-  // oRPC query keys are structured as [[...path], { type, input }].
-  useSignal(ANNOUNCEMENT_UPDATED, () => {
-    void refetch();
-  });
+  const { data, isLoading } = announcementClient.getActiveAnnouncements.useQuery();
 
   // Server-side dismiss — extract stable mutate function to avoid re-renders
   const { mutate: dismissOnServer } =

package/src/components/DashboardAnnouncements.tsx

@@ -1,7 +1,6 @@
 import React, { useState } from "react";
 import { usePluginClient } from "@checkstack/frontend-api";
-import { AnnouncementApi, ANNOUNCEMENT_UPDATED, type Announcement } from "@checkstack/announcement-common";
-import { useSignal } from "@checkstack/signal-frontend";
+import { AnnouncementApi, type Announcement } from "@checkstack/announcement-common";
 import { MarkdownBlock } from "@checkstack/ui";
 import {
   Info,
@@ -103,16 +102,11 @@ export const DashboardAnnouncements: React.FC = () => {
   const announcementClient = usePluginClient(AnnouncementApi);
 
   // Always refetch on mount so the dashboard shows fresh data when navigated to.
-  // Also subscribe to signals for instant updates while actively viewing.
-  const { data, isLoading, refetch } =
-    announcementClient.getActiveAnnouncements.useQuery(
-      { includeDismissed: true },
-      { refetchOnMount: "always" },
-    );
-
-  useSignal(ANNOUNCEMENT_UPDATED, () => {
-    void refetch();
-  });
+  // Realtime updates arrive via SignalAutoInvalidator on `[["announcement"]]`.
+  const { data, isLoading } = announcementClient.getActiveAnnouncements.useQuery(
+    { includeDismissed: true },
+    { refetchOnMount: "always" },
+  );
 
   const dashboardAnnouncements = React.useMemo(() => {
     if (!data?.announcements) return [];