@harperfast/harper 5.0.0-alpha.10

package/dist/components/status/ComponentStatusRegistry.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * ComponentStatusRegistry Class
+ *
+ * This module contains the ComponentStatusRegistry class which provides
+ * centralized management of component health status.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentStatusRegistry = void 0;
+const ComponentStatus_ts_1 = require("./ComponentStatus.js");
+const types_ts_1 = require("./types.js");
+const crossThread_ts_1 = require("./crossThread.js");
+const errors_ts_1 = require("./errors.js");
+/**
+ * Component Status Registry Class
+ * Provides a centralized registry for managing component health status
+ */
+class ComponentStatusRegistry {
+    statusMap = new Map();
+    /**
+     * Reset the component status registry, clearing all existing status data
+     * This should be called when the component system starts up
+     */
+    reset() {
+        this.statusMap = new Map();
+    }
+    /**
+     * Register or update component health status
+     * This function allows components to report their own health status
+     */
+    setStatus(componentName, status, message, error) {
+        if (!componentName || typeof componentName !== 'string') {
+            throw new errors_ts_1.ComponentStatusOperationError(String(componentName), 'setStatus', 'Component name must be a non-empty string');
+        }
+        if (!Object.values(types_ts_1.COMPONENT_STATUS_LEVELS).includes(status)) {
+            throw new errors_ts_1.ComponentStatusOperationError(componentName, 'setStatus', `Invalid status level: ${status}. Must be one of: ${Object.values(types_ts_1.COMPONENT_STATUS_LEVELS).join(', ')}`);
+        }
+        this.statusMap.set(componentName, new ComponentStatus_ts_1.ComponentStatus(status, message, error));
+    }
+    /**
+     * Get the current status of a component
+     */
+    getStatus(componentName) {
+        return this.statusMap.get(componentName);
+    }
+    /**
+     * Get all component statuses
+     */
+    getAllStatuses() {
+        return this.statusMap;
+    }
+    /**
+     * Report component as healthy
+     */
+    reportHealthy(componentName, message) {
+        this.setStatus(componentName, types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY, message);
+    }
+    /**
+     * Report component error
+     */
+    reportError(componentName, error, message) {
+        this.setStatus(componentName, types_ts_1.COMPONENT_STATUS_LEVELS.ERROR, message, error);
+    }
+    /**
+     * Report component warning
+     */
+    reportWarning(componentName, message) {
+        this.setStatus(componentName, types_ts_1.COMPONENT_STATUS_LEVELS.WARNING, message);
+    }
+    /**
+     * Component Lifecycle Management
+     */
+    /**
+     * Initialize component as loading - call this when component loading begins
+     */
+    initializeLoading(componentName, message) {
+        this.setStatus(componentName, types_ts_1.COMPONENT_STATUS_LEVELS.LOADING, message || 'Component is loading');
+    }
+    /**
+     * Mark component as successfully loaded
+     */
+    markLoaded(componentName, message) {
+        this.setStatus(componentName, types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY, message || 'Component loaded successfully');
+    }
+    /**
+     * Mark component as failed to load
+     */
+    markFailed(componentName, error, message) {
+        this.setStatus(componentName, types_ts_1.COMPONENT_STATUS_LEVELS.ERROR, message, error);
+    }
+    /**
+     * Get all components with a specific status level
+     */
+    getComponentsByStatus(statusLevel) {
+        const result = [];
+        for (const [name, status] of this.statusMap) {
+            if (status.status === statusLevel) {
+                result.push({ name, status });
+            }
+        }
+        return result;
+    }
+    /**
+     * Get a summary of all component statuses
+     */
+    getStatusSummary() {
+        const summary = {
+            [types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY]: 0,
+            [types_ts_1.COMPONENT_STATUS_LEVELS.ERROR]: 0,
+            [types_ts_1.COMPONENT_STATUS_LEVELS.WARNING]: 0,
+            [types_ts_1.COMPONENT_STATUS_LEVELS.LOADING]: 0,
+            [types_ts_1.COMPONENT_STATUS_LEVELS.UNKNOWN]: 0,
+        };
+        for (const status of this.statusMap.values()) {
+            summary[status.status]++;
+        }
+        return summary;
+    }
+    /**
+     * Static method to get aggregated component statuses from all threads
+     * Returns a Map with one entry per component showing overall status and thread distribution
+     */
+    static async getAggregatedFromAllThreads(registry) {
+        const allStatuses = await crossThread_ts_1.crossThreadCollector.collect(registry);
+        return crossThread_ts_1.StatusAggregator.aggregate(allStatuses);
+    }
+    /**
+     * 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
+     */
+    async getAggregatedStatusFor(componentName, consolidatedStatuses) {
+        // Get consolidated statuses from all threads if not provided
+        if (!consolidatedStatuses) {
+            consolidatedStatuses = await ComponentStatusRegistry.getAggregatedFromAllThreads(this);
+        }
+        // Collect all statuses related to this component
+        const allStatuses = [];
+        const componentPrefix = componentName + '.';
+        // Add exact match if exists
+        const exactMatch = consolidatedStatuses.get(componentName);
+        if (exactMatch) {
+            allStatuses.push({ key: componentName, ...exactMatch });
+        }
+        // Add sub-component statuses
+        for (const [statusKey, statusValue] of consolidatedStatuses) {
+            if (statusKey.startsWith(componentPrefix)) {
+                allStatuses.push({ key: statusKey, ...statusValue });
+            }
+        }
+        if (allStatuses.length === 0) {
+            // No status found at all
+            return {
+                status: types_ts_1.COMPONENT_STATUS_LEVELS.UNKNOWN,
+                message: 'The component has not been loaded yet (may need a restart)',
+                lastChecked: { workers: {} },
+            };
+        }
+        // Aggregate all statuses
+        const hasErrors = allStatuses.some((s) => s.status === types_ts_1.COMPONENT_STATUS_LEVELS.ERROR);
+        const hasLoading = allStatuses.some((s) => s.status === types_ts_1.COMPONENT_STATUS_LEVELS.LOADING);
+        const overallStatus = hasErrors
+            ? types_ts_1.COMPONENT_STATUS_LEVELS.ERROR
+            : hasLoading
+                ? types_ts_1.COMPONENT_STATUS_LEVELS.LOADING
+                : types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY;
+        // Show details if anything is not healthy
+        let overallMessage = 'All components loaded successfully';
+        const details = {};
+        if (hasErrors || hasLoading) {
+            const problemStatuses = allStatuses.filter((s) => s.status === types_ts_1.COMPONENT_STATUS_LEVELS.ERROR || s.status === types_ts_1.COMPONENT_STATUS_LEVELS.LOADING);
+            overallMessage = problemStatuses.map((s) => `${s.key}: ${s.latestMessage || s.status}`).join('; ');
+            // Include details for debugging
+            for (const status of allStatuses) {
+                if (status.status !== types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY) {
+                    details[status.key] = {
+                        status: status.status,
+                        message: status.latestMessage,
+                    };
+                }
+            }
+        }
+        return {
+            status: overallStatus,
+            message: overallMessage,
+            ...(Object.keys(details).length > 0 && { details }),
+            lastChecked: allStatuses[0]?.lastChecked || { workers: {} },
+        };
+    }
+}
+exports.ComponentStatusRegistry = ComponentStatusRegistry;
+//# sourceMappingURL=ComponentStatusRegistry.js.map

package/dist/components/status/ComponentStatusRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentStatusRegistry.js","sourceRoot":"","sources":["../../../components/status/ComponentStatusRegistry.ts"],"names":[],"mappings":"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"}

package/dist/components/status/api.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Component Status Public API
+ *
+ * This module provides the clean, simple public API for component status tracking.
+ * All internal implementation details are hidden behind this interface.
+ */
+import { ComponentStatus } from './ComponentStatus.ts';
+/**
+ * Component Status Builder
+ * Provides a fluent interface for reporting component status
+ */
+export declare class ComponentStatusBuilder {
+    private componentName;
+    constructor(componentName: string);
+    /**
+     * Report component as healthy
+     * @param message Optional status message
+     * @returns this for chaining
+     */
+    healthy(message?: string): this;
+    /**
+     * Report component warning
+     * @param message Warning message (required for warnings)
+     * @returns this for chaining
+     */
+    warning(message: string): this;
+    /**
+     * Report component error
+     * @param message Error message
+     * @param error Optional error object for additional context
+     * @returns this for chaining
+     */
+    error(message: string, error?: Error): this;
+    /**
+     * Report component as loading
+     * @param message Optional loading message
+     * @returns this for chaining
+     */
+    loading(message?: string): this;
+    /**
+     * Report component status as unknown
+     * @param message Optional message explaining why status is unknown
+     * @returns this for chaining
+     */
+    unknown(message?: string): this;
+    /**
+     * Get the current status of this component
+     * @returns Current component status or undefined if not set
+     */
+    get(): ComponentStatus | undefined;
+}
+/**
+ * Get a status builder for a component
+ * This is the primary API for reporting component status
+ *
+ * @example
+ * ```typescript
+ * // Report status
+ * statusForComponent('my-service').healthy('Service started');
+ * statusForComponent('database').error('Connection failed', err);
+ * statusForComponent('cache').warning('Memory usage high');
+ *
+ * // Get status
+ * const status = statusForComponent('my-service').get();
+ * ```
+ */
+export declare function statusForComponent(name: string): ComponentStatusBuilder;
+/**
+ * Component lifecycle hooks for internal use
+ * These are used by the component loader
+ */
+export declare const lifecycle: {
+    /**
+     * Mark component as starting to load
+     */
+    loading(componentName: string, message?: string): void;
+    /**
+     * Mark component as successfully loaded
+     */
+    loaded(componentName: string, message?: string): void;
+    /**
+     * Mark component as failed to load
+     */
+    failed(componentName: string, error: Error | string, message?: string): void;
+};
+/**
+ * Reset all component statuses (useful for testing)
+ */
+export declare function reset(): void;
+/**
+ * Status level constants for external use
+ */
+export declare const STATUS: {
+    readonly HEALTHY: "healthy";
+    readonly WARNING: "warning";
+    readonly ERROR: "error";
+    readonly UNKNOWN: "unknown";
+    readonly LOADING: "loading";
+};
+/**
+ * Re-export only the types that external users need
+ */
+export type { ComponentStatusLevel, AggregatedComponentStatus } from './types.ts';
+export type { ComponentStatus } from './ComponentStatus.ts';

package/dist/components/status/api.js

@@ -0,0 +1,137 @@
+"use strict";
+/**
+ * Component Status Public API
+ *
+ * This module provides the clean, simple public API for component status tracking.
+ * All internal implementation details are hidden behind this interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STATUS = exports.lifecycle = exports.ComponentStatusBuilder = void 0;
+exports.statusForComponent = statusForComponent;
+exports.reset = reset;
+const registry_ts_1 = require("./registry.js");
+const types_ts_1 = require("./types.js");
+/**
+ * Component Status Builder
+ * Provides a fluent interface for reporting component status
+ */
+class ComponentStatusBuilder {
+    componentName;
+    constructor(componentName) {
+        this.componentName = componentName;
+    }
+    /**
+     * Report component as healthy
+     * @param message Optional status message
+     * @returns this for chaining
+     */
+    healthy(message) {
+        registry_ts_1.componentStatusRegistry.setStatus(this.componentName, types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY, message);
+        return this;
+    }
+    /**
+     * Report component warning
+     * @param message Warning message (required for warnings)
+     * @returns this for chaining
+     */
+    warning(message) {
+        registry_ts_1.componentStatusRegistry.setStatus(this.componentName, types_ts_1.COMPONENT_STATUS_LEVELS.WARNING, message);
+        return this;
+    }
+    /**
+     * Report component error
+     * @param message Error message
+     * @param error Optional error object for additional context
+     * @returns this for chaining
+     */
+    error(message, error) {
+        registry_ts_1.componentStatusRegistry.setStatus(this.componentName, types_ts_1.COMPONENT_STATUS_LEVELS.ERROR, message, error);
+        return this;
+    }
+    /**
+     * Report component as loading
+     * @param message Optional loading message
+     * @returns this for chaining
+     */
+    loading(message) {
+        registry_ts_1.componentStatusRegistry.setStatus(this.componentName, types_ts_1.COMPONENT_STATUS_LEVELS.LOADING, message || 'Loading...');
+        return this;
+    }
+    /**
+     * Report component status as unknown
+     * @param message Optional message explaining why status is unknown
+     * @returns this for chaining
+     */
+    unknown(message) {
+        registry_ts_1.componentStatusRegistry.setStatus(this.componentName, types_ts_1.COMPONENT_STATUS_LEVELS.UNKNOWN, message);
+        return this;
+    }
+    /**
+     * Get the current status of this component
+     * @returns Current component status or undefined if not set
+     */
+    get() {
+        return registry_ts_1.componentStatusRegistry.getStatus(this.componentName);
+    }
+}
+exports.ComponentStatusBuilder = ComponentStatusBuilder;
+// Cache for builders to avoid creating new objects
+const builderCache = new Map();
+/**
+ * Get a status builder for a component
+ * This is the primary API for reporting component status
+ *
+ * @example
+ * ```typescript
+ * // Report status
+ * statusForComponent('my-service').healthy('Service started');
+ * statusForComponent('database').error('Connection failed', err);
+ * statusForComponent('cache').warning('Memory usage high');
+ *
+ * // Get status
+ * const status = statusForComponent('my-service').get();
+ * ```
+ */
+function statusForComponent(name) {
+    let builder = builderCache.get(name);
+    if (!builder) {
+        builder = new ComponentStatusBuilder(name);
+        builderCache.set(name, builder);
+    }
+    return builder;
+}
+/**
+ * Component lifecycle hooks for internal use
+ * These are used by the component loader
+ */
+exports.lifecycle = {
+    /**
+     * Mark component as starting to load
+     */
+    loading(componentName, message) {
+        registry_ts_1.componentStatusRegistry.initializeLoading(componentName, message);
+    },
+    /**
+     * Mark component as successfully loaded
+     */
+    loaded(componentName, message) {
+        registry_ts_1.componentStatusRegistry.markLoaded(componentName, message);
+    },
+    /**
+     * Mark component as failed to load
+     */
+    failed(componentName, error, message) {
+        registry_ts_1.componentStatusRegistry.markFailed(componentName, error, message);
+    },
+};
+/**
+ * Reset all component statuses (useful for testing)
+ */
+function reset() {
+    registry_ts_1.componentStatusRegistry.reset();
+}
+/**
+ * Status level constants for external use
+ */
+exports.STATUS = types_ts_1.COMPONENT_STATUS_LEVELS;
+//# sourceMappingURL=api.js.map

package/dist/components/status/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../components/status/api.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA+FH,gDAOC;AAgCD,sBAEC;AAtID,+CAAwD;AAExD,yCAAqD;AAErD;;;GAGG;AACH,MAAa,sBAAsB;IAC1B,aAAa,CAAS;IAE9B,YAAY,aAAqB;QAChC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAgB;QACvB,qCAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAe;QACtB,qCAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAe,EAAE,KAAa;QACnC,qCAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,kCAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACrG,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAgB;QACvB,qCAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,IAAI,YAAY,CAAC,CAAC;QAChH,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAgB;QACvB,qCAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,kCAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAChG,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;OAGG;IACH,GAAG;QACF,OAAO,qCAAuB,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9D,CAAC;CACD;AAjED,wDAiEC;AAED,mDAAmD;AACnD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkC,CAAC;AAE/D;;;;;;;;;;;;;;GAcG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC9C,IAAI,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC3C,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;GAGG;AACU,QAAA,SAAS,GAAG;IACxB;;OAEG;IACH,OAAO,CAAC,aAAqB,EAAE,OAAgB;QAC9C,qCAAuB,CAAC,iBAAiB,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAqB,EAAE,OAAgB;QAC7C,qCAAuB,CAAC,UAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAqB,EAAE,KAAqB,EAAE,OAAgB;QACpE,qCAAuB,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;CACD,CAAC;AAEF;;GAEG;AACH,SAAgB,KAAK;IACpB,qCAAuB,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACU,QAAA,MAAM,GAAG,kCAAuB,CAAC"}

package/dist/components/status/crossThread.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Cross-Thread Component Status Collection
+ *
+ * This module handles collecting component status information from all worker threads
+ * and aggregating it into a unified view.
+ */
+import { ComponentStatusRegistry } from './ComponentStatusRegistry.ts';
+import { type ComponentStatusSummary, type AggregatedComponentStatus } from './types.ts';
+/**
+ * CrossThreadStatusCollector Class
+ * Handles collection of component status from all worker threads
+ */
+export declare class CrossThreadStatusCollector {
+    private awaitingResponses;
+    private responseCheckers;
+    private nextRequestId;
+    private listenerAttached;
+    private readonly timeout;
+    private cleanupTimer;
+    constructor(timeoutMs?: number);
+    /**
+     * Attach the message listener for cross-thread responses
+     * This is done once per collector instance to avoid duplicate listeners
+     */
+    private attachListener;
+    /**
+     * Schedule cleanup of stale requests if needed
+     */
+    private scheduleCleanup;
+    /**
+     * Collect component status information from all threads
+     * Returns a Map with component names namespaced by worker index
+     */
+    collect(registry: ComponentStatusRegistry): Promise<Map<string, ComponentStatusSummary>>;
+    /**
+     * Get status from local thread only (fallback when cross-thread collection fails)
+     */
+    private getLocalStatusOnly;
+    /**
+     * Clean up any pending requests and timers (useful for testing)
+     */
+    cleanup(): void;
+}
+/**
+ * StatusAggregator Class
+ * Handles aggregation of component statuses from multiple threads
+ */
+export declare class StatusAggregator {
+    /**
+     * Aggregate component statuses from multiple threads into aggregated view
+     */
+    static aggregate(allStatuses: Map<string, ComponentStatusSummary>): Map<string, AggregatedComponentStatus>;
+    /**
+     * Aggregate status entries for a single component across threads
+     */
+    private static aggregateComponentGroup;
+    /**
+     * Determine overall status based on priority
+     */
+    private static determineOverallStatus;
+}
+export declare const crossThreadCollector: CrossThreadStatusCollector;