@checkstack/healthcheck-backend 0.0.2

package/CHANGELOG.md

@@ -0,0 +1,181 @@
+# @checkstack/healthcheck-backend
+
+## 0.0.2
+
+### Patch Changes
+
+- d20d274: Initial release of all @checkstack packages. Rebranded from Checkmate to Checkstack with new npm organization @checkstack and domain checkstack.dev.
+- Updated dependencies [d20d274]
+  - @checkstack/backend-api@0.0.2
+  - @checkstack/catalog-backend@0.0.2
+  - @checkstack/catalog-common@0.0.2
+  - @checkstack/command-backend@0.0.2
+  - @checkstack/common@0.0.2
+  - @checkstack/healthcheck-common@0.0.2
+  - @checkstack/integration-backend@0.0.2
+  - @checkstack/queue-api@0.0.2
+  - @checkstack/signal-common@0.0.2
+
+## 0.2.0
+
+### Minor Changes
+
+- a65e002: Add command palette commands and deep-linking support
+
+  **Backend Changes:**
+
+  - `healthcheck-backend`: Add "Manage Health Checks" (⇧⌘H) and "Create Health Check" commands
+  - `catalog-backend`: Add "Manage Systems" (⇧⌘S) and "Create System" commands
+  - `integration-backend`: Add "Manage Integrations" (⇧⌘G), "Create Integration Subscription", and "View Integration Logs" commands
+  - `auth-backend`: Add "Manage Users" (⇧⌘U), "Create User", "Manage Roles", and "Manage Applications" commands
+  - `command-backend`: Auto-cleanup command registrations when plugins are deregistered
+
+  **Frontend Changes:**
+
+  - `HealthCheckConfigPage`: Handle `?action=create` URL parameter
+  - `CatalogConfigPage`: Handle `?action=create` URL parameter
+  - `IntegrationsPage`: Handle `?action=create` URL parameter
+  - `AuthSettingsPage`: Handle `?tab=` and `?action=create` URL parameters
+
+### Patch Changes
+
+- Updated dependencies [4c5aa9e]
+- Updated dependencies [b4eb432]
+- Updated dependencies [a65e002]
+- Updated dependencies [a65e002]
+  - @checkstack/integration-backend@0.1.0
+  - @checkstack/backend-api@1.1.0
+  - @checkstack/common@0.2.0
+  - @checkstack/command-backend@0.1.0
+  - @checkstack/catalog-backend@0.1.0
+  - @checkstack/queue-api@1.0.1
+  - @checkstack/catalog-common@0.1.2
+  - @checkstack/healthcheck-common@0.1.1
+  - @checkstack/signal-common@0.1.1
+
+## 0.1.1
+
+### Patch Changes
+
+- @checkstack/catalog-common@0.1.1
+- @checkstack/catalog-backend@0.0.3
+
+## 0.1.0
+
+### Minor Changes
+
+- ae19ff6: Add configurable state thresholds for health check evaluation
+
+  **@checkstack/backend-api:**
+
+  - Added `VersionedData<T>` generic interface as base for all versioned data structures
+  - `VersionedConfig<T>` now extends `VersionedData<T>` and adds `pluginId`
+  - Added `migrateVersionedData()` utility function for running migrations on any `VersionedData` subtype
+
+  **@checkstack/backend:**
+
+  - Refactored `ConfigMigrationRunner` to use the new `migrateVersionedData` utility
+
+  **@checkstack/healthcheck-common:**
+
+  - Added state threshold schemas with two evaluation modes (consecutive, window)
+  - Added `stateThresholds` field to `AssociateHealthCheckSchema`
+  - Added `getSystemHealthStatus` RPC endpoint contract
+
+  **@checkstack/healthcheck-backend:**
+
+  - Added `stateThresholds` column to `system_health_checks` table
+  - Added `state-evaluator.ts` with health status evaluation logic
+  - Added `state-thresholds-migrations.ts` with migration infrastructure
+  - Added `getSystemHealthStatus` RPC handler
+
+  **@checkstack/healthcheck-frontend:**
+
+  - Updated `SystemHealthBadge` to use new backend endpoint
+
+- 0babb9c: Add public health status access and detailed history for admins
+
+  **Permission changes:**
+
+  - Added `healthcheck.status.read` permission with `isPublicDefault: true` for anonymous access
+  - `getSystemHealthStatus`, `getSystemHealthOverview`, and `getHistory` now public
+  - `getHistory` no longer returns `result` field (security)
+
+  **New features:**
+
+  - Added `getDetailedHistory` endpoint with `healthcheck.manage` permission
+  - New `/healthcheck/history` page showing paginated run history with expandable result JSON
+
+### Patch Changes
+
+- e4d83fc: Add BullMQ queue plugin with orphaned job cleanup
+
+  - **queue-api**: Added `listRecurringJobs()` method to Queue interface for detecting orphaned jobs
+  - **queue-bullmq-backend**: New plugin implementing BullMQ (Redis) queue backend with job schedulers, consumer groups, and distributed job persistence
+  - **queue-bullmq-common**: New common package with queue permissions
+  - **queue-memory-backend**: Implemented `listRecurringJobs()` for in-memory queue
+  - **healthcheck-backend**: Enhanced `bootstrapHealthChecks` to clean up orphaned job schedulers using `listRecurringJobs()`
+  - **test-utils-backend**: Added `listRecurringJobs()` to mock queue factory
+
+  This enables production-ready distributed queue processing with Redis persistence and automatic cleanup of orphaned jobs when health checks are deleted.
+
+- 81f3f85: ## Breaking: Unified Versioned<T> Architecture
+
+  Refactored the versioning system to use a unified `Versioned<T>` class instead of separate `VersionedSchema`, `VersionedData`, and `VersionedConfig` types.
+
+  ### Breaking Changes
+
+  - **`VersionedSchema<T>`** is replaced by `Versioned<T>` class
+  - **`VersionedData<T>`** is replaced by `VersionedRecord<T>` interface
+  - **`VersionedConfig<T>`** is replaced by `VersionedPluginRecord<T>` interface
+  - **`ConfigMigration<F, T>`** is replaced by `Migration<F, T>` interface
+  - **`MigrationChain<T>`** is removed (use `Migration<unknown, unknown>[]`)
+  - **`migrateVersionedData()`** is removed (use `versioned.parse()`)
+  - **`ConfigMigrationRunner`** is removed (migrations are internal to Versioned)
+
+  ### Migration Guide
+
+  Before:
+
+  ```typescript
+  const strategy: HealthCheckStrategy = {
+    config: {
+      version: 1,
+      schema: mySchema,
+      migrations: [],
+    },
+  };
+  const data = await migrateVersionedData(stored, 1, migrations);
+  ```
+
+  After:
+
+  ```typescript
+  const strategy: HealthCheckStrategy = {
+    config: new Versioned({
+      version: 1,
+      schema: mySchema,
+      migrations: [],
+    }),
+  };
+  const data = await strategy.config.parse(stored);
+  ```
+
+- Updated dependencies [ffc28f6]
+- Updated dependencies [e4d83fc]
+- Updated dependencies [4dd644d]
+- Updated dependencies [71275dd]
+- Updated dependencies [ae19ff6]
+- Updated dependencies [0babb9c]
+- Updated dependencies [b55fae6]
+- Updated dependencies [b354ab3]
+- Updated dependencies [8e889b4]
+- Updated dependencies [81f3f85]
+  - @checkstack/common@0.1.0
+  - @checkstack/backend-api@1.0.0
+  - @checkstack/catalog-common@0.1.0
+  - @checkstack/queue-api@1.0.0
+  - @checkstack/healthcheck-common@0.1.0
+  - @checkstack/signal-common@0.1.0
+  - @checkstack/catalog-backend@0.0.2
+  - @checkstack/integration-backend@0.0.2

package/drizzle/0000_stormy_slayback.sql

@@ -0,0 +1,33 @@
+CREATE TYPE "health_check_status" AS ENUM('healthy', 'unhealthy', 'degraded');--> statement-breakpoint
+CREATE TABLE "health_check_configurations" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"name" text NOT NULL,
+	"strategy_id" text NOT NULL,
+	"config" jsonb NOT NULL,
+	"interval_seconds" integer NOT NULL,
+	"is_template" boolean DEFAULT false,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "health_check_runs" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"configuration_id" uuid NOT NULL,
+	"system_id" text NOT NULL,
+	"status" "health_check_status" NOT NULL,
+	"result" jsonb,
+	"timestamp" timestamp DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "system_health_checks" (
+	"system_id" text NOT NULL,
+	"configuration_id" uuid NOT NULL,
+	"enabled" boolean DEFAULT true NOT NULL,
+	"state_thresholds" jsonb,
+	"created_at" timestamp DEFAULT now() NOT NULL,
+	"updated_at" timestamp DEFAULT now() NOT NULL,
+	CONSTRAINT "system_health_checks_system_id_configuration_id_pk" PRIMARY KEY("system_id","configuration_id")
+);
+--> statement-breakpoint
+ALTER TABLE "health_check_runs" ADD CONSTRAINT "health_check_runs_configuration_id_health_check_configurations_id_fk" FOREIGN KEY ("configuration_id") REFERENCES "health_check_configurations"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "system_health_checks" ADD CONSTRAINT "system_health_checks_configuration_id_health_check_configurations_id_fk" FOREIGN KEY ("configuration_id") REFERENCES "health_check_configurations"("id") ON DELETE cascade ON UPDATE no action;

package/drizzle/0001_thin_shotgun.sql

@@ -0,0 +1 @@
+ALTER TABLE "health_check_runs" ADD COLUMN "latency_ms" integer;

package/drizzle/0002_closed_lucky_pierre.sql

@@ -0,0 +1,19 @@
+CREATE TYPE "bucket_size" AS ENUM('hourly', 'daily');--> statement-breakpoint
+CREATE TABLE "health_check_aggregates" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"configuration_id" uuid NOT NULL,
+	"system_id" text NOT NULL,
+	"bucket_start" timestamp NOT NULL,
+	"bucket_size" "bucket_size" NOT NULL,
+	"run_count" integer NOT NULL,
+	"healthy_count" integer NOT NULL,
+	"degraded_count" integer NOT NULL,
+	"unhealthy_count" integer NOT NULL,
+	"avg_latency_ms" integer,
+	"min_latency_ms" integer,
+	"max_latency_ms" integer,
+	"p95_latency_ms" integer,
+	"aggregated_metadata" jsonb
+);
+--> statement-breakpoint
+ALTER TABLE "health_check_aggregates" ADD CONSTRAINT "health_check_aggregates_configuration_id_health_check_configurations_id_fk" FOREIGN KEY ("configuration_id") REFERENCES "health_check_configurations"("id") ON DELETE cascade ON UPDATE no action;

package/drizzle/0003_powerful_rage.sql

@@ -0,0 +1 @@
+ALTER TABLE "system_health_checks" ADD COLUMN "retention_config" jsonb;

package/drizzle/0004_short_ezekiel.sql

@@ -0,0 +1 @@
+CREATE UNIQUE INDEX "health_check_aggregates_bucket_unique" ON "health_check_aggregates" USING btree ("configuration_id","system_id","bucket_start","bucket_size");

package/drizzle/0005_glossy_longshot.sql

@@ -0,0 +1 @@
+ALTER TABLE "health_check_aggregates" RENAME COLUMN "aggregated_metadata" TO "aggregated_result";

package/drizzle/meta/0000_snapshot.json

@@ -0,0 +1,234 @@
+{
+  "id": "74a6fab2-e8df-4d0f-a2af-669d072ecdf5",
+  "prevId": "00000000-0000-0000-0000-000000000000",
+  "version": "7",
+  "dialect": "postgresql",
+  "tables": {
+    "public.health_check_configurations": {
+      "name": "health_check_configurations",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "strategy_id": {
+          "name": "strategy_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "config": {
+          "name": "config",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "interval_seconds": {
+          "name": "interval_seconds",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "is_template": {
+          "name": "is_template",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.health_check_runs": {
+      "name": "health_check_runs",
+      "schema": "",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "uuid",
+          "primaryKey": true,
+          "notNull": true,
+          "default": "gen_random_uuid()"
+        },
+        "configuration_id": {
+          "name": "configuration_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "system_id": {
+          "name": "system_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "status": {
+          "name": "status",
+          "type": "health_check_status",
+          "typeSchema": "public",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "result": {
+          "name": "result",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "timestamp": {
+          "name": "timestamp",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "health_check_runs_configuration_id_health_check_configurations_id_fk": {
+          "name": "health_check_runs_configuration_id_health_check_configurations_id_fk",
+          "tableFrom": "health_check_runs",
+          "tableTo": "health_check_configurations",
+          "columnsFrom": [
+            "configuration_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    },
+    "public.system_health_checks": {
+      "name": "system_health_checks",
+      "schema": "",
+      "columns": {
+        "system_id": {
+          "name": "system_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "configuration_id": {
+          "name": "configuration_id",
+          "type": "uuid",
+          "primaryKey": false,
+          "notNull": true
+        },
+        "enabled": {
+          "name": "enabled",
+          "type": "boolean",
+          "primaryKey": false,
+          "notNull": true,
+          "default": true
+        },
+        "state_thresholds": {
+          "name": "state_thresholds",
+          "type": "jsonb",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "timestamp",
+          "primaryKey": false,
+          "notNull": true,
+          "default": "now()"
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "system_health_checks_configuration_id_health_check_configurations_id_fk": {
+          "name": "system_health_checks_configuration_id_health_check_configurations_id_fk",
+          "tableFrom": "system_health_checks",
+          "tableTo": "health_check_configurations",
+          "columnsFrom": [
+            "configuration_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "system_health_checks_system_id_configuration_id_pk": {
+          "name": "system_health_checks_system_id_configuration_id_pk",
+          "columns": [
+            "system_id",
+            "configuration_id"
+          ]
+        }
+      },
+      "uniqueConstraints": {},
+      "policies": {},
+      "checkConstraints": {},
+      "isRLSEnabled": false
+    }
+  },
+  "enums": {
+    "public.health_check_status": {
+      "name": "health_check_status",
+      "schema": "public",
+      "values": [
+        "healthy",
+        "unhealthy",
+        "degraded"
+      ]
+    }
+  },
+  "schemas": {},
+  "sequences": {},
+  "roles": {},
+  "policies": {},
+  "views": {},
+  "_meta": {
+    "columns": {},
+    "schemas": {},
+    "tables": {}
+  }
+}