@pax8-cta/core 0.1.0

package/dist/services/health-check.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Copyright 2024 Pax8, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { HealthCheck, TenantConfig } from "../config/schema.js";
+import { DataverseClient } from "../dataverse/client.js";
+/**
+ * Result of a health check
+ */
+export interface HealthCheckResult {
+    healthy: boolean;
+    tenantId: string;
+    tenantName: string;
+    checks: {
+        name: string;
+        passed: boolean;
+        message: string;
+        durationMs: number;
+    }[];
+    totalDurationMs: number;
+}
+/**
+ * Service for performing health checks on tenant environments
+ */
+export declare class HealthCheckService {
+    /**
+     * Perform all health checks for a tenant
+     */
+    checkTenantHealth(tenant: TenantConfig, client: DataverseClient, settings?: HealthCheck): Promise<HealthCheckResult>;
+    /**
+     * Check basic Dataverse connectivity
+     */
+    private checkDataverseConnectivity;
+    /**
+     * Check a custom health endpoint
+     */
+    private checkCustomEndpoint;
+    /**
+     * Check if solution import is possible (verify permissions)
+     */
+    private checkSolutionImportCapability;
+    /**
+     * Run health checks for multiple tenants in parallel
+     */
+    checkMultipleTenants(tenants: TenantConfig[], clientFactory: (tenant: TenantConfig) => Promise<DataverseClient>, options?: {
+        maxConcurrent?: number;
+        onProgress?: (completed: number, total: number) => void;
+    }): Promise<HealthCheckResult[]>;
+    /**
+     * Generate a health report summary
+     */
+    generateReport(results: HealthCheckResult[]): {
+        totalTenants: number;
+        healthyTenants: number;
+        unhealthyTenants: number;
+        unhealthyDetails: {
+            tenantName: string;
+            tenantId: string;
+            failedChecks: string[];
+        }[];
+    };
+}
+export declare const healthCheckService: HealthCheckService;
+export interface TenantHealth {
+    tenantId: string;
+    tenantName: string;
+    healthScore: number;
+    status: "healthy" | "warning" | "critical";
+    lastChecked: string;
+    issues: HealthIssue[];
+    gdapStatus: "valid" | "missing_role" | "expired" | "propagating" | "unknown";
+    connectionsStatus: "valid" | "expired" | "missing" | "unknown";
+    recentSuccessRate: number;
+    recentDeployments: {
+        total: number;
+        successful: number;
+        failed: number;
+    };
+}
+export interface TenantHealthDetail extends TenantHealth {
+    gdap: {
+        status: "valid" | "missing_role" | "expired" | "propagating" | "unknown";
+        roles?: string[];
+        missingRoles?: string[];
+        relationshipExpiry?: string;
+        lastVerified: string;
+        issue?: string;
+    };
+    connections: Array<{
+        name: string;
+        displayName: string;
+        status: "valid" | "expired" | "missing";
+        expiryDate?: string;
+        issue?: string;
+    }>;
+    recentDeploymentHistory: Array<{
+        id: string;
+        timestamp: string;
+        status: "success" | "failure";
+        duration?: number;
+        error?: string;
+    }>;
+    recommendations: string[];
+}
+export interface HealthIssue {
+    severity: "info" | "warning" | "error" | "critical";
+    category: "permissions" | "connections" | "health" | "history";
+    message: string;
+    resolution?: string;
+    link?: string;
+}
+export interface DeploymentHistoryRecord {
+    tenantId: string;
+    status: "success" | "failure";
+    error?: string;
+    completedAt: string;
+    durationMinutes?: number;
+}
+export interface HealthCheckContext {
+    tenantId: string;
+    tenantName: string;
+    environmentUrl: string;
+    tags?: string[];
+    deploymentHistory?: DeploymentHistoryRecord[];
+}
+export declare class TenantHealthMonitoringService {
+    private cache;
+    private readonly CACHE_DURATION_MS;
+    /**
+     * Check health for a single tenant
+     */
+    checkTenantHealth(context: HealthCheckContext, skipCache?: boolean): Promise<TenantHealth>;
+    /**
+     * Check detailed health for a single tenant
+     */
+    checkTenantHealthDetail(context: HealthCheckContext, skipCache?: boolean): Promise<TenantHealthDetail>;
+    /**
+     * Check health for multiple tenants
+     */
+    checkMultipleTenants(contexts: HealthCheckContext[], skipCache?: boolean): Promise<TenantHealth[]>;
+    /**
+     * Clear cache for a tenant or all tenants
+     */
+    clearCache(tenantId?: string): void;
+    private checkGDAPHealth;
+    private checkConnectionsHealth;
+    private analyzeDeploymentHistory;
+    private getGDAPDetail;
+    private getConnectionsDetail;
+    private getRecentDeploymentHistory;
+    private generateRecommendations;
+    private calculateHealthScore;
+    private determineStatus;
+}
+export declare const tenantHealthMonitoringService: TenantHealthMonitoringService;
+export declare const healthChecker: TenantHealthMonitoringService;
+//# sourceMappingURL=health-check.d.ts.map

package/dist/services/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/services/health-check.ts"],"names":[],"mappings":"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"}