harperdb 4.7.0-beta.1 → 4.7.0-beta.3

package/components/status/ComponentStatusRegistry.d.ts

@@ -5,7 +5,7 @@
  * centralized management of component health status.
  */
 import { ComponentStatus } from './ComponentStatus.ts';
-import { type ComponentStatusLevel, type AggregatedComponentStatus } from './types.ts';
+import { type ComponentStatusLevel, type AggregatedComponentStatus, type ComponentApplicationStatus } from './types.ts';
 /**
  * Map of component names to their status information
  */
@@ -77,4 +77,13 @@ export declare class ComponentStatusRegistry {
      * Returns a Map with one entry per component showing overall status and thread distribution
      */
     static getAggregatedFromAllThreads(registry: ComponentStatusRegistry): Promise<Map<string, AggregatedComponentStatus>>;
+    /**
+     * Get aggregated status for a specific component and all its sub-components
+     * This method handles both exact matches and sub-component aggregation
+     *
+     * @param componentName - The component name to look up (e.g., "application-template", "http")
+     * @param consolidatedStatuses - Pre-fetched consolidated statuses from all threads (optional, will fetch if not provided)
+     * @returns Aggregated status information for the component
+     */
+    getAggregatedStatusFor(componentName: string, consolidatedStatuses?: Map<string, AggregatedComponentStatus>): Promise<ComponentApplicationStatus>;
 }

package/components/status/types.d.ts

@@ -73,3 +73,22 @@ export interface WorkerComponentStatuses {
     isMainThread: boolean;
     statuses: Array<[string, ComponentStatusSummary]>;
 }
+/**
+ * Aggregated application-level component status
+ * Used for components that may have multiple sub-components (e.g., application-template.rest, application-template.static)
+ */
+export interface ComponentApplicationStatus {
+    /** Overall aggregated status (error > loading > loaded > healthy) */
+    status: ComponentStatusLevel;
+    /** Descriptive message with details when not healthy */
+    message: string;
+    /** Detailed breakdown when issues exist */
+    details?: Record<string, {
+        status: ComponentStatusLevel;
+        message?: string;
+    }>;
+    /** Last checked time information */
+    lastChecked: {
+        workers: Record<number, number>;
+    };
+}