@checkstack/notification-common 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @checkstack/notification-common
 
+## 1.1.1
+
+### Patch Changes
+
+- a06b899: Dead-code audit cleanup and a small platform of shared notification helpers.
+
+  **Removed (dead code)**
+
+  - `core/backend/src/plugin-manager/deregistration-guard.ts` deleted. The exported `assertCanDeregister()` was never called and was a less-complete version of the dependents+isUninstallable checks already done inline by `previewUninstallOriginator` / `uninstallOriginator` in `plugin-manager-orchestrator.ts`.
+  - `createMockQueueFactory` deprecated alias removed from `@checkstack/test-utils-backend`. Use `createMockQueueManager` directly.
+
+  **New shared helpers**
+
+  - `@checkstack/backend-api` now exports `requestTimeoutMs()` — a Zod field builder for outbound HTTP request timeouts (1s..60s, default 10s). Replaces hand-rolled `configNumber({}).min(1000).max(60_000).default(10_000)` in `integration-webhook-backend`, `integration-script-backend`, and `healthcheck-script-backend`'s inline collector.
+  - `@checkstack/notification-common` now exports `SubjectStatusSchema` / `SubjectStatus`, mirroring the existing `ImportanceSchema`.
+  - `@checkstack/notification-backend` now exports:
+    - `SUBJECT_STATUS_EMOJI` / `IMPORTANCE_EMOJI` — the shared status / importance emoji maps that Discord, Slack, Teams, Webex and Telegram previously each redefined inline.
+    - `postJson(opts)` — a timeout-bounded `fetch` wrapper that handles non-2xx logging and error mapping for webhook-style POSTs. Returns `{ ok: true, response } | { ok: false, error }`.
+
+  **Migrated to shared helpers**
+
+  - Discord, Slack, Gotify, Pushover notification backends now use `postJson`. Outer try/catch + per-plugin error mapping deleted (~140 LOC).
+  - Discord, Slack, Teams, Telegram, Webex notification backends now use `IMPORTANCE_EMOJI`. Discord, Slack, Teams use `SUBJECT_STATUS_EMOJI`.
+  - Teams, Webex, Backstage, Telegram kept their inline fetch/Bot logic: their error strings surface server response bodies to operators, or the transport isn't raw `fetch` (Telegram uses `grammy`'s `Bot`).
+
+  **API surface tightening**
+
+  - Per-plugin test-only re-exports in 6 notification backends (Pushover, Gotify, Backstage, Slack, Discord, Teams) and the `CertificateInfo` interface in `healthcheck-tls-backend/strategy.ts` are now JSDoc-tagged `@internal`. No behaviour change; signals that downstream consumers must not depend on them.
+
 ## 1.1.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/notification-common",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "license": "Elastic-2.0",
   "type": "module",
   "exports": {
@@ -10,15 +10,15 @@
     }
   },
   "dependencies": {
-    "@checkstack/common": "0.9.0",
-    "@checkstack/signal-common": "0.2.2",
+    "@checkstack/common": "0.10.0",
+    "@checkstack/signal-common": "0.2.3",
     "@orpc/contract": "^1.13.14",
     "zod": "^4.0.0"
   },
   "devDependencies": {
     "@checkstack/tsconfig": "0.0.7",
     "typescript": "^5.7.2",
-    "@checkstack/scripts": "0.3.1"
+    "@checkstack/scripts": "0.3.2"
   },
   "scripts": {
     "typecheck": "tsgo -b",

package/src/schemas.ts

@@ -4,6 +4,15 @@ import { z } from "zod";
 export const ImportanceSchema = z.enum(["info", "warning", "critical"]);
 export type Importance = z.infer<typeof ImportanceSchema>;
 
+// Optional health/status hint for affected subjects.
+export const SubjectStatusSchema = z.enum([
+  "healthy",
+  "unhealthy",
+  "degraded",
+  "unknown",
+]);
+export type SubjectStatus = z.infer<typeof SubjectStatusSchema>;
+
 // Notification action for CTA buttons
 export const NotificationActionSchema = z.object({
   label: z.string(),
@@ -48,7 +57,7 @@ export const NotificationSubjectSchema = z.object({
    * Optional health/status hint, used to color the chip and add an icon.
    * Strategies that cannot render color simply ignore it.
    */
-  status: z.enum(["healthy", "unhealthy", "degraded", "unknown"]).optional(),
+  status: SubjectStatusSchema.optional(),
 });
 export type NotificationSubject = z.infer<typeof NotificationSubjectSchema>;