@checkstack/healthcheck-backend 0.0.2 → 0.0.3

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @checkstack/healthcheck-backend
 
+## 0.0.3
+
+### Patch Changes
+
+- cb82e4d: Improved `counter` and `pie` auto-chart types to show frequency distributions instead of just the latest value. Both chart types now count occurrences of each unique value across all runs/buckets, making them more intuitive for visualizing data like HTTP status codes.
+
+  Changed HTTP health check chart annotations: `statusCode` now uses `pie` chart (distribution view), `contentType` now uses `counter` chart (frequency count).
+
+  Fixed scrollbar hopping when health check signals update the accordion content. All charts now update silently without layout shift or loading state flicker.
+
+  Refactored health check visualization architecture:
+
+  - `HealthCheckStatusTimeline` and `HealthCheckLatencyChart` now accept `HealthCheckDiagramSlotContext` directly, handling data transformation internally
+  - `HealthCheckDiagram` refactored to accept context from parent, ensuring all visualizations share the same data source and update together on signals
+  - `HealthCheckSystemOverview` simplified to use `useHealthCheckData` hook for consolidated data fetching with automatic signal-driven refresh
+
+  Added `silentRefetch()` method to `usePagination` hook for background data refreshes without showing loading indicators.
+
+  Fixed `useSignal` hook to use a ref pattern internally, preventing stale closure issues. Callbacks now always access the latest values without requiring manual memoization or refs in consumer components.
+
+  Added signal handling to `useHealthCheckData` hook for automatic chart refresh when health check runs complete.
+
+- Updated dependencies [cb82e4d]
+  - @checkstack/healthcheck-common@0.0.3
+
 ## 0.0.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/healthcheck-backend",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "main": "src/index.ts",
   "scripts": {

package/src/router.ts

@@ -1,7 +1,7 @@
 import { implement, ORPCError } from "@orpc/server";
 import {
   autoAuthMiddleware,
-  zod,
+  toJsonSchema,
   type RpcContext,
   type HealthCheckRegistry,
 } from "@checkstack/backend-api";
@@ -9,6 +9,7 @@ import { healthCheckContract } from "@checkstack/healthcheck-common";
 import { HealthCheckService } from "./service";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
 import * as schema from "./schema";
+import { toJsonSchemaWithChartMeta } from "./schema-utils";
 
 /**
  * Creates the healthcheck router using contract-based implementation.
@@ -34,9 +35,13 @@ export const createHealthCheckRouter = (
         id: s.id,
         displayName: s.displayName,
         description: s.description,
-        configSchema: zod.toJSONSchema(s.config.schema),
-        resultSchema: s.result ? zod.toJSONSchema(s.result.schema) : undefined,
-        aggregatedResultSchema: zod.toJSONSchema(s.aggregatedResult.schema),
+        configSchema: toJsonSchema(s.config.schema),
+        resultSchema: s.result
+          ? toJsonSchemaWithChartMeta(s.result.schema)
+          : undefined,
+        aggregatedResultSchema: toJsonSchemaWithChartMeta(
+          s.aggregatedResult.schema
+        ),
       }));
     }),
 

package/src/schema-utils.ts

@@ -0,0 +1,83 @@
+/**
+ * Schema utilities for health check JSON Schema conversion.
+ *
+ * Extends the base toJsonSchema to also include chart metadata from the
+ * healthResultRegistry for auto-chart rendering.
+ */
+
+import { z, toJsonSchema } from "@checkstack/backend-api";
+import { getHealthResultMeta } from "@checkstack/healthcheck-common";
+
+/**
+ * Adds health result chart metadata to JSON Schema properties.
+ * Recursively processes nested objects and arrays.
+ */
+function addHealthResultMeta(
+  zodSchema: z.ZodTypeAny,
+  jsonSchema: Record<string, unknown>
+): void {
+  // Handle arrays - recurse into items
+  if (zodSchema instanceof z.ZodArray) {
+    const itemsSchema = (zodSchema as z.ZodArray<z.ZodTypeAny>).element;
+    const jsonItems = jsonSchema.items as Record<string, unknown> | undefined;
+    if (jsonItems) {
+      addHealthResultMeta(itemsSchema, jsonItems);
+    }
+    return;
+  }
+
+  // Handle optional - unwrap and recurse
+  if (zodSchema instanceof z.ZodOptional) {
+    const innerSchema = zodSchema.unwrap() as z.ZodTypeAny;
+    addHealthResultMeta(innerSchema, jsonSchema);
+    return;
+  }
+
+  // Type guard to check if this is an object schema
+  if (!("shape" in zodSchema)) return;
+
+  const objectSchema = zodSchema as z.ZodObject<z.ZodRawShape>;
+  const properties = jsonSchema.properties as
+    | Record<string, Record<string, unknown>>
+    | undefined;
+
+  if (!properties) return;
+
+  for (const [key, fieldSchema] of Object.entries(objectSchema.shape)) {
+    const zodField = fieldSchema as z.ZodTypeAny;
+    const jsonField = properties[key];
+
+    if (!jsonField) continue;
+
+    // Get health result metadata from registry (x-chart-type, etc.)
+    const healthMeta = getHealthResultMeta(zodField);
+    if (healthMeta) {
+      if (healthMeta["x-chart-type"])
+        jsonField["x-chart-type"] = healthMeta["x-chart-type"];
+      if (healthMeta["x-chart-label"])
+        jsonField["x-chart-label"] = healthMeta["x-chart-label"];
+      if (healthMeta["x-chart-unit"])
+        jsonField["x-chart-unit"] = healthMeta["x-chart-unit"];
+    }
+
+    // Recurse into nested objects and arrays
+    addHealthResultMeta(zodField, jsonField);
+  }
+}
+
+/**
+ * Converts a Zod schema to JSON Schema with chart metadata.
+ *
+ * This extends the base toJsonSchema to also include health check
+ * chart metadata (x-chart-type, x-chart-label, x-chart-unit) from
+ * the healthResultRegistry for auto-chart rendering.
+ */
+export function toJsonSchemaWithChartMeta(
+  zodSchema: z.ZodTypeAny
+): Record<string, unknown> {
+  // Use the base toJsonSchema which handles config metadata
+  const jsonSchema = toJsonSchema(zodSchema);
+  // Add health result chart metadata
+  addHealthResultMeta(zodSchema, jsonSchema);
+  return jsonSchema;
+}

package/src/service.ts

@@ -614,10 +614,15 @@ export class HealthCheckService {
       if (!bucketMap.has(key)) {
         bucketMap.set(key, { bucketStart, runs: [] });
       }
+      // run.result is StoredHealthCheckResult: { status, latencyMs, message, metadata }
+      // Strategy's aggregateResult expects metadata to be the strategy-specific fields
+      const storedResult = run.result as {
+        metadata?: Record<string, unknown>;
+      } | null;
       bucketMap.get(key)!.runs.push({
         status: run.status,
         latencyMs: run.latencyMs ?? undefined,
-        metadata: run.result ?? undefined,
+        metadata: storedResult?.metadata ?? undefined,
       });
     }
 
@@ -637,7 +642,7 @@ export class HealthCheckService {
 
       const latencies = bucket.runs
         .map((r) => r.latencyMs)
-        .filter((l): l is number => l !== null);
+        .filter((l): l is number => typeof l === "number");
       const avgLatencyMs =
         latencies.length > 0
           ? Math.round(latencies.reduce((a, b) => a + b, 0) / latencies.length)