@checkstack/healthcheck-common 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # @checkstack/healthcheck-common
 
+## 0.8.0
+
+### Minor Changes
+
+- d6f7449: Add availability statistics display to HealthCheckSystemOverview
+
+  - New `getAvailabilityStats` RPC endpoint that calculates availability percentages for 31-day and 365-day periods
+  - Availability is calculated as `(healthyRuns / totalRuns) * 100`
+  - Data is sourced from both daily aggregates and recent raw runs to include the most up-to-date information
+  - Frontend displays availability stats with color-coded badges (green ≥99.9%, yellow ≥99%, red <99%)
+  - Shows total run counts for each period
+
+## 0.7.0
+
+### Minor Changes
+
+- 1f81b60: ### Clickable Run History with Deep Linking
+
+  **Backend (`healthcheck-backend`):**
+
+  - Added `getRunById` service method to fetch a single health check run by ID
+
+  **Schema (`healthcheck-common`):**
+
+  - Added `getRunById` RPC procedure for fetching individual runs
+  - Added `historyRun` route for deep linking to specific runs (`/history/:systemId/:configurationId/:runId`)
+
+  **Frontend (`healthcheck-frontend`):**
+
+  - Table rows in Recent Runs and Run History now navigate to detailed view instead of expanding inline
+  - Added "Selected Run" card that displays when navigating to a specific run
+  - Extracted `ExpandedResultView` into reusable component
+  - Fixed layout shift during table pagination by preserving previous data while loading
+  - Removed accordion expansion in favor of consistent navigation UX
+
+### Patch Changes
+
+- 090143b: ### Health Check Aggregation & UI Fixes
+
+  **Backend (`healthcheck-backend`):**
+
+  - Fixed tail-end bucket truncation where the last aggregated bucket was cut off at the interval boundary instead of extending to the query end date
+  - Added `rangeEnd` parameter to `reaggregateBuckets()` to properly extend the last bucket
+  - Fixed cross-tier merge logic (`mergeTieredBuckets`) to prevent hourly aggregates from blocking fresh raw data
+
+  **Schema (`healthcheck-common`):**
+
+  - Added `bucketEnd` field to `AggregatedBucketBaseSchema` so frontends know the actual end time of each bucket
+
+  **Frontend (`healthcheck-frontend`):**
+
+  - Updated all components to use `bucket.bucketEnd` instead of calculating from `bucketIntervalSeconds`
+  - Fixed aggregation mode detection: changed `>` to `>=` so 7-day queries use aggregated data when `rawRetentionDays` is 7
+  - Added ref-based memoization in `useHealthCheckData` to prevent layout shift during signal-triggered refetches
+  - Exposed `isFetching` state to show loading spinner during background refetches
+  - Added debounced custom date range with Apply button to prevent fetching on every field change
+  - Added validation preventing start date >= end date in custom ranges
+  - Added sparkline downsampling: when there are 60+ data points, they are aggregated into buckets with informative tooltips
+
+  **UI (`ui`):**
+
+  - Fixed `DateRangeFilter` presets to use true sliding windows (removed `startOfDay` from 7-day and 30-day ranges)
+  - Added `disabled` prop to `DateRangeFilter` and `DateTimePicker` components
+  - Added `onCustomChange` prop to `DateRangeFilter` for debounced custom date handling
+  - Improved layout: custom date pickers now inline with preset buttons on desktop
+  - Added responsive mobile layout: date pickers stack vertically with down arrow
+  - Added validation error display for invalid date ranges
+
 ## 0.6.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/healthcheck-common",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "type": "module",
   "exports": {
     ".": {

package/src/routes.ts

@@ -7,4 +7,5 @@ export const healthcheckRoutes = createRoutes("healthcheck", {
   config: "/config",
   history: "/history",
   historyDetail: "/history/:systemId/:configurationId",
+  historyRun: "/history/:systemId/:configurationId/:runId",
 });

package/src/rpc-contract.ts

@@ -222,6 +222,7 @@ export const healthCheckContract = {
         endDate: z.date().optional(),
         limit: z.number().optional().default(10),
         offset: z.number().optional().default(0),
+        sortOrder: z.enum(["asc", "desc"]),
       }),
     )
     .output(
@@ -244,6 +245,7 @@ export const healthCheckContract = {
         endDate: z.date().optional(),
         limit: z.number().optional().default(10),
         offset: z.number().optional().default(0),
+        sortOrder: z.enum(["asc", "desc"]),
       }),
     )
     .output(
@@ -253,6 +255,18 @@ export const healthCheckContract = {
       }),
     ),
 
+  getRunById: proc({
+    operationType: "query",
+    userType: "authenticated",
+    access: [healthCheckAccess.details],
+  })
+    .input(
+      z.object({
+        runId: z.string(),
+      }),
+    )
+    .output(HealthCheckRunSchema.optional()),
+
   getAggregatedHistory: proc({
     operationType: "query",
     userType: "public",
@@ -349,8 +363,27 @@ export const healthCheckContract = {
         ),
       }),
     ),
-};
 
+  getAvailabilityStats: proc({
+    operationType: "query",
+    userType: "public",
+    access: [healthCheckAccess.status],
+  })
+    .input(
+      z.object({
+        systemId: z.string(),
+        configurationId: z.string(),
+      }),
+    )
+    .output(
+      z.object({
+        availability31Days: z.number().nullable(),
+        availability365Days: z.number().nullable(),
+        totalRuns31Days: z.number(),
+        totalRuns365Days: z.number(),
+      }),
+    ),
+};
 // Export contract type
 export type HealthCheckContract = typeof healthCheckContract;
 

package/src/schemas.ts

@@ -280,6 +280,8 @@ export const DEFAULT_RETENTION_CONFIG: RetentionConfig = {
  */
 export const AggregatedBucketBaseSchema = z.object({
   bucketStart: z.date(),
+  /** Actual end time of this bucket (may differ from start + interval for the last bucket) */
+  bucketEnd: z.date(),
   /** @deprecated Use bucketIntervalSeconds instead. Kept for backward compatibility. */
   bucketSize: z.enum(["hourly", "daily"]).optional(),
   /** Bucket interval in seconds (e.g., 7 for 7-second buckets) */