@harperfast/harper 5.0.0-alpha.10

package/dist/components/status/crossThread.js

@@ -0,0 +1,343 @@
+"use strict";
+/**
+ * Cross-Thread Component Status Collection
+ *
+ * This module handles collecting component status information from all worker threads
+ * and aggregating it into a unified view.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.crossThreadCollector = exports.StatusAggregator = exports.CrossThreadStatusCollector = void 0;
+const itc_js_1 = require("../../server/threads/itc.js");
+const manageThreads_js_1 = require("../../server/threads/manageThreads.js");
+const hdbTerms_ts_1 = require("../../utility/hdbTerms.js");
+const logger_ts_1 = require("../../utility/logging/logger.js");
+const types_ts_1 = require("./types.js");
+const errors_ts_1 = require("./errors.js");
+const logger = (0, logger_ts_1.loggerWithTag)('componentStatus.crossThread');
+/**
+ * CrossThreadStatusCollector Class
+ * Handles collection of component status from all worker threads
+ */
+class CrossThreadStatusCollector {
+    awaitingResponses = new Map();
+    responseCheckers = new Map();
+    nextRequestId = 1;
+    listenerAttached = false;
+    timeout;
+    cleanupTimer = null;
+    constructor(timeoutMs = 5000) {
+        this.timeout = timeoutMs;
+    }
+    /**
+     * Attach the message listener for cross-thread responses
+     * This is done once per collector instance to avoid duplicate listeners
+     */
+    attachListener() {
+        if (this.listenerAttached) {
+            return;
+        }
+        (0, manageThreads_js_1.onMessageByType)(hdbTerms_ts_1.ITC_EVENT_TYPES.COMPONENT_STATUS_RESPONSE, ({ message }) => {
+            const workerLabel = message.isMainThread ? 'main' : `worker-${message.workerIndex}`;
+            logger.trace?.('Received component status response from %s, with requestId: %d', workerLabel, message.requestId);
+            // Find the pending request by requestId
+            const pendingResponses = this.awaitingResponses.get(message.requestId);
+            if (pendingResponses) {
+                pendingResponses.push({
+                    workerIndex: message.workerIndex,
+                    isMainThread: message.isMainThread || false,
+                    statuses: message.statuses || [],
+                });
+                // Check if we've received all expected responses
+                const checkComplete = this.responseCheckers.get(message.requestId);
+                if (checkComplete) {
+                    checkComplete();
+                }
+            }
+        });
+        this.listenerAttached = true;
+    }
+    /**
+     * Schedule cleanup of stale requests if needed
+     */
+    scheduleCleanup() {
+        // Clear any existing timer
+        if (this.cleanupTimer) {
+            clearTimeout(this.cleanupTimer);
+        }
+        // Schedule cleanup in 30 seconds if there are pending requests
+        if (this.awaitingResponses.size > 0) {
+            this.cleanupTimer = setTimeout(() => {
+                if (this.awaitingResponses.size > 0) {
+                    logger.debug?.(`Cleaning up ${this.awaitingResponses.size} stale pending requests`);
+                    this.awaitingResponses.clear();
+                }
+                this.cleanupTimer = null;
+            }, 30000);
+        }
+    }
+    /**
+     * Collect component status information from all threads
+     * Returns a Map with component names namespaced by worker index
+     */
+    async collect(registry) {
+        try {
+            // Ensure listener is attached
+            this.attachListener();
+            // Reset cleanup timer on each collect call
+            this.scheduleCleanup();
+            // Generate unique request ID and set up response collection
+            const requestId = this.nextRequestId++;
+            const responses = [];
+            this.awaitingResponses.set(requestId, responses);
+            // Calculate expected number of responses
+            // Total threads = main thread (1) + worker threads (workerCount)
+            const workerCount = (0, manageThreads_js_1.getWorkerCount)() || 1;
+            const totalThreads = workerCount + 1;
+            // We expect responses from all threads except ourselves
+            const expectedResponses = totalThreads - 1;
+            // Set up response collection with timeout
+            const responsePromise = new Promise((resolve, reject) => {
+                let resolved = false;
+                // Check if we've received all expected responses
+                const checkComplete = () => {
+                    const collectedResponses = this.awaitingResponses.get(requestId);
+                    if (collectedResponses && collectedResponses.length >= expectedResponses && !resolved) {
+                        resolved = true;
+                        cleanup();
+                        logger.trace?.(`Collected all ${collectedResponses.length} expected responses for request ${requestId}`);
+                        resolve(collectedResponses);
+                    }
+                };
+                // Set up timeout as fallback
+                const timeoutHandle = setTimeout(() => {
+                    if (!resolved) {
+                        resolved = true;
+                        const collectedResponses = this.awaitingResponses.get(requestId) || [];
+                        this.awaitingResponses.delete(requestId);
+                        // Log timeout with diagnostic info
+                        logger.debug?.(`Collection timeout for request ${requestId}: collected ${collectedResponses.length}/${expectedResponses} responses`);
+                        // Resolve with whatever we've collected so far
+                        resolve(collectedResponses);
+                    }
+                }, this.timeout);
+                // Ensure cleanup happens no matter what
+                const cleanup = () => {
+                    this.awaitingResponses.delete(requestId);
+                    clearTimeout(timeoutHandle);
+                };
+                // Store check function for this request
+                this.responseCheckers.set(requestId, checkComplete);
+                // Broadcast to ALL threads
+                (0, itc_js_1.sendItcEvent)({
+                    type: hdbTerms_ts_1.ITC_EVENT_TYPES.COMPONENT_STATUS_REQUEST,
+                    message: { requestId },
+                })
+                    .then(() => {
+                    // Request sent successfully, check if we already have all responses
+                    checkComplete();
+                })
+                    .catch((error) => {
+                    resolved = true;
+                    cleanup();
+                    this.responseCheckers.delete(requestId);
+                    reject(new errors_ts_1.ITCError('sendItcEvent', error));
+                });
+            });
+            // Get the collected responses for this request
+            const collectedResponses = await responsePromise;
+            // Clean up response checker
+            this.responseCheckers.delete(requestId);
+            // Aggregate responses from all threads
+            const aggregatedStatuses = new Map();
+            // Add local thread's component status
+            const localStatuses = registry.getAllStatuses();
+            const localWorkerIndex = (0, manageThreads_js_1.getWorkerIndex)();
+            const localThreadLabel = localWorkerIndex === undefined ? 'main' : `worker-${localWorkerIndex}`;
+            for (const [name, status] of localStatuses) {
+                aggregatedStatuses.set(`${name}@${localThreadLabel}`, {
+                    ...status,
+                    workerIndex: localWorkerIndex,
+                });
+            }
+            // Add responses from other threads
+            for (const response of collectedResponses) {
+                for (const [name, status] of response.statuses) {
+                    const threadLabel = response.isMainThread ? 'main' : `worker-${response.workerIndex}`;
+                    aggregatedStatuses.set(`${name}@${threadLabel}`, {
+                        ...status,
+                        workerIndex: response.workerIndex,
+                    });
+                }
+            }
+            logger.debug?.(`Collected component status from ${collectedResponses.length + 1} threads (including local)`);
+            return aggregatedStatuses;
+        }
+        catch (error) {
+            if (error instanceof errors_ts_1.ITCError) {
+                logger.error?.(`ITC failure during component status collection: ${error.message}`);
+            }
+            else {
+                logger.warn?.('Failed to collect component status from all threads:', error);
+            }
+            // Log diagnostic information
+            logger.debug?.(`Collection failed for request. Error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            // Fallback to local status only
+            return this.getLocalStatusOnly(registry);
+        }
+    }
+    /**
+     * Get status from local thread only (fallback when cross-thread collection fails)
+     */
+    getLocalStatusOnly(registry) {
+        const localStatuses = registry.getAllStatuses();
+        const fallbackStatuses = new Map();
+        const localWorkerIndex = (0, manageThreads_js_1.getWorkerIndex)();
+        const localThreadLabel = localWorkerIndex === undefined ? 'main' : `worker-${localWorkerIndex}`;
+        for (const [name, status] of localStatuses) {
+            fallbackStatuses.set(`${name}@${localThreadLabel}`, {
+                ...status,
+                workerIndex: localWorkerIndex,
+            });
+        }
+        return fallbackStatuses;
+    }
+    /**
+     * Clean up any pending requests and timers (useful for testing)
+     */
+    cleanup() {
+        this.awaitingResponses.clear();
+        this.responseCheckers.clear();
+        if (this.cleanupTimer) {
+            clearTimeout(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+}
+exports.CrossThreadStatusCollector = CrossThreadStatusCollector;
+/**
+ * StatusAggregator Class
+ * Handles aggregation of component statuses from multiple threads
+ */
+class StatusAggregator {
+    /**
+     * Aggregate component statuses from multiple threads into aggregated view
+     */
+    static aggregate(allStatuses) {
+        const aggregatedMap = new Map();
+        // Group statuses by component name (without thread suffix)
+        const componentGroups = new Map();
+        for (const [nameWithThread, status] of allStatuses) {
+            // Extract component name without thread suffix (e.g., "myComponent@worker-1" -> "myComponent")
+            const atIndex = nameWithThread.indexOf('@');
+            const componentName = atIndex !== -1 ? nameWithThread.substring(0, atIndex) : nameWithThread;
+            let group = componentGroups.get(componentName);
+            if (!group) {
+                group = [];
+                componentGroups.set(componentName, group);
+            }
+            group.push([nameWithThread, status]);
+        }
+        // Process each component group
+        for (const [componentName, statusEntries] of componentGroups) {
+            const aggregated = this.aggregateComponentGroup(componentName, statusEntries);
+            aggregatedMap.set(componentName, aggregated);
+        }
+        return aggregatedMap;
+    }
+    /**
+     * Aggregate status entries for a single component across threads
+     */
+    static aggregateComponentGroup(componentName, statusEntries) {
+        const lastCheckedTimes = {
+            workers: {},
+        };
+        let mostRecentCheckTime = 0;
+        let latestMessage;
+        let error;
+        const statusCounts = new Map();
+        const abnormalities = new Map();
+        // Analyze all instances of this component
+        for (const [nameWithThread, status] of statusEntries) {
+            const atIndex = nameWithThread.lastIndexOf('@');
+            const threadLabel = atIndex !== -1 ? nameWithThread.substring(atIndex + 1) : '';
+            // Convert lastChecked to ms since epoch
+            const checkTime = status.lastChecked instanceof Date ? status.lastChecked.getTime() : new Date(status.lastChecked).getTime();
+            // Store the last checked time based on thread label
+            if (threadLabel === 'main') {
+                lastCheckedTimes.main = checkTime;
+            }
+            else if (threadLabel && threadLabel.startsWith('worker-')) {
+                const workerIndex = parseInt(threadLabel.substring(7)); // 'worker-'.length = 7
+                if (!isNaN(workerIndex)) {
+                    lastCheckedTimes.workers[workerIndex] = checkTime;
+                }
+            }
+            // Track status counts
+            statusCounts.set(status.status, (statusCounts.get(status.status) || 0) + 1);
+            // Track messages - prioritize non-healthy messages
+            if (status.status !== types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY && status.message) {
+                if (!latestMessage || checkTime > mostRecentCheckTime) {
+                    mostRecentCheckTime = checkTime;
+                    latestMessage = status.message;
+                }
+            }
+            // Capture any error
+            if (status.error && !error) {
+                error = status.error;
+            }
+        }
+        // Determine overall status (priority: error > warning > loading > unknown > healthy)
+        const determinedStatus = this.determineOverallStatus(statusCounts);
+        // Check for abnormalities (inconsistent statuses across threads)
+        const uniqueStatuses = Array.from(statusCounts.keys());
+        if (uniqueStatuses.length > 1) {
+            // There are inconsistencies - populate abnormalities
+            for (const [nameWithThread, status] of statusEntries) {
+                if (status.status !== determinedStatus) {
+                    abnormalities.set(nameWithThread, {
+                        workerIndex: status.workerIndex !== undefined ? status.workerIndex : -1,
+                        status: status.status,
+                        message: status.message,
+                        error: status.error,
+                    });
+                }
+            }
+        }
+        // Create aggregated status
+        const aggregatedStatus = {
+            componentName,
+            status: determinedStatus,
+            lastChecked: lastCheckedTimes,
+            latestMessage,
+            error,
+        };
+        // Only add abnormalities if there are any
+        if (abnormalities.size > 0) {
+            aggregatedStatus.abnormalities = abnormalities;
+        }
+        return aggregatedStatus;
+    }
+    /**
+     * Determine overall status based on priority
+     */
+    static determineOverallStatus(statusCounts) {
+        const statusPriority = [
+            types_ts_1.COMPONENT_STATUS_LEVELS.ERROR,
+            types_ts_1.COMPONENT_STATUS_LEVELS.WARNING,
+            types_ts_1.COMPONENT_STATUS_LEVELS.LOADING,
+            types_ts_1.COMPONENT_STATUS_LEVELS.UNKNOWN,
+            types_ts_1.COMPONENT_STATUS_LEVELS.HEALTHY,
+        ];
+        for (const priorityStatus of statusPriority) {
+            if (statusCounts.has(priorityStatus) && statusCounts.get(priorityStatus) > 0) {
+                return priorityStatus;
+            }
+        }
+        return types_ts_1.COMPONENT_STATUS_LEVELS.UNKNOWN;
+    }
+}
+exports.StatusAggregator = StatusAggregator;
+// Create singleton instances with configurable timeout
+const TIMEOUT_MS = parseInt(process.env.COMPONENT_STATUS_TIMEOUT || '5000');
+exports.crossThreadCollector = new CrossThreadStatusCollector(TIMEOUT_MS);
+//# sourceMappingURL=crossThread.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crossThread.js","sourceRoot":"","sources":["../../../components/status/crossThread.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,wDAA2D;AAC3D,4EAAwG;AACxG,2DAA4D;AAC5D,+DAAgE;AAEhE,yCAOoB;AACpB,2CAAuC;AAEvC,MAAM,MAAM,GAAG,IAAA,yBAAa,EAAC,6BAA6B,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAa,0BAA0B;IAC9B,iBAAiB,GAAG,IAAI,GAAG,EAA0C,CAAC;IACtE,gBAAgB,GAAG,IAAI,GAAG,EAAsB,CAAC;IACjD,aAAa,GAAG,CAAC,CAAC;IAClB,gBAAgB,GAAG,KAAK,CAAC;IAChB,OAAO,CAAS;IACzB,YAAY,GAA0B,IAAI,CAAC;IAEnD,YAAY,YAAoB,IAAI;QACnC,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACK,cAAc;QACrB,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO;QACR,CAAC;QAED,IAAA,kCAAe,EAAC,6BAAe,CAAC,yBAAyB,EAAE,CAAC,EAAE,OAAO,EAAO,EAAE,EAAE;YAC/E,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,OAAO,CAAC,WAAW,EAAE,CAAC;YACpF,MAAM,CAAC,KAAK,EAAE,CAAC,gEAAgE,EAAE,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAEjH,wCAAwC;YACxC,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACvE,IAAI,gBAAgB,EAAE,CAAC;gBACtB,gBAAgB,CAAC,IAAI,CAAC;oBACrB,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK;oBAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;iBAChC,CAAC,CAAC;gBAEH,iDAAiD;gBACjD,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACnE,IAAI,aAAa,EAAE,CAAC;oBACnB,aAAa,EAAE,CAAC;gBACjB,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,eAAe;QACtB,2BAA2B;QAC3B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC;QAED,+DAA+D;QAC/D,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;gBACnC,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;oBACrC,MAAM,CAAC,KAAK,EAAE,CAAC,eAAe,IAAI,CAAC,iBAAiB,CAAC,IAAI,yBAAyB,CAAC,CAAC;oBACpF,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;gBAChC,CAAC;gBACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAC1B,CAAC,EAAE,KAAK,CAAC,CAAC;QACX,CAAC;IACF,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,OAAO,CAAC,QAAiC;QACrD,IAAI,CAAC;YACJ,8BAA8B;YAC9B,IAAI,CAAC,cAAc,EAAE,CAAC;YAEtB,2CAA2C;YAC3C,IAAI,CAAC,eAAe,EAAE,CAAC;YAEvB,4DAA4D;YAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,MAAM,SAAS,GAAmC,EAAE,CAAC;YACrD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAEjD,yCAAyC;YACzC,iEAAiE;YACjE,MAAM,WAAW,GAAG,IAAA,iCAAc,GAAE,IAAI,CAAC,CAAC;YAC1C,MAAM,YAAY,GAAG,WAAW,GAAG,CAAC,CAAC;YACrC,wDAAwD;YACxD,MAAM,iBAAiB,GAAG,YAAY,GAAG,CAAC,CAAC;YAE3C,0CAA0C;YAC1C,MAAM,eAAe,GAAG,IAAI,OAAO,CAAiC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACvF,IAAI,QAAQ,GAAG,KAAK,CAAC;gBAErB,iDAAiD;gBACjD,MAAM,aAAa,GAAG,GAAG,EAAE;oBAC1B,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBACjE,IAAI,kBAAkB,IAAI,kBAAkB,CAAC,MAAM,IAAI,iBAAiB,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACvF,QAAQ,GAAG,IAAI,CAAC;wBAChB,OAAO,EAAE,CAAC;wBACV,MAAM,CAAC,KAAK,EAAE,CAAC,iBAAiB,kBAAkB,CAAC,MAAM,mCAAmC,SAAS,EAAE,CAAC,CAAC;wBACzG,OAAO,CAAC,kBAAkB,CAAC,CAAC;oBAC7B,CAAC;gBACF,CAAC,CAAC;gBAEF,6BAA6B;gBAC7B,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;oBACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACf,QAAQ,GAAG,IAAI,CAAC;wBAChB,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;wBACvE,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;wBACzC,mCAAmC;wBACnC,MAAM,CAAC,KAAK,EAAE,CACb,kCAAkC,SAAS,eAAe,kBAAkB,CAAC,MAAM,IAAI,iBAAiB,YAAY,CACpH,CAAC;wBACF,+CAA+C;wBAC/C,OAAO,CAAC,kBAAkB,CAAC,CAAC;oBAC7B,CAAC;gBACF,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBAEjB,wCAAwC;gBACxC,MAAM,OAAO,GAAG,GAAG,EAAE;oBACpB,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBACzC,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC7B,CAAC,CAAC;gBAEF,wCAAwC;gBACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAEpD,2BAA2B;gBAC3B,IAAA,qBAAY,EAAC;oBACZ,IAAI,EAAE,6BAAe,CAAC,wBAAwB;oBAC9C,OAAO,EAAE,EAAE,SAAS,EAAE;iBACtB,CAAC;qBACA,IAAI,CAAC,GAAG,EAAE;oBACV,oEAAoE;oBACpE,aAAa,EAAE,CAAC;gBACjB,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,KAAY,EAAE,EAAE;oBACvB,QAAQ,GAAG,IAAI,CAAC;oBAChB,OAAO,EAAE,CAAC;oBACV,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBACxC,MAAM,CAAC,IAAI,oBAAQ,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC7C,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,+CAA+C;YAC/C,MAAM,kBAAkB,GAAG,MAAM,eAAe,CAAC;YAEjD,4BAA4B;YAC5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAExC,uCAAuC;YACvC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkC,CAAC;YAErE,sCAAsC;YACtC,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;YAChD,MAAM,gBAAgB,GAAG,IAAA,iCAAc,GAAE,CAAC;YAC1C,MAAM,gBAAgB,GAAG,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,gBAAgB,EAAE,CAAC;YAEhG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;gBAC5C,kBAAkB,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,gBAAgB,EAAE,EAAE;oBACrD,GAAG,MAAM;oBACT,WAAW,EAAE,gBAAgB;iBAC7B,CAAC,CAAC;YACJ,CAAC;YAED,mCAAmC;YACnC,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,CAAC;gBAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBAChD,MAAM,WAAW,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,QAAQ,CAAC,WAAW,EAAE,CAAC;oBACtF,kBAAkB,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,WAAW,EAAE,EAAE;wBAChD,GAAG,MAAM;wBACT,WAAW,EAAE,QAAQ,CAAC,WAAW;qBACjC,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YAED,MAAM,CAAC,KAAK,EAAE,CAAC,mCAAmC,kBAAkB,CAAC,MAAM,GAAG,CAAC,4BAA4B,CAAC,CAAC;YAC7G,OAAO,kBAAkB,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,oBAAQ,EAAE,CAAC;gBAC/B,MAAM,CAAC,KAAK,EAAE,CAAC,mDAAmD,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpF,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,IAAI,EAAE,CAAC,sDAAsD,EAAE,KAAK,CAAC,CAAC;YAC9E,CAAC;YAED,6BAA6B;YAC7B,MAAM,CAAC,KAAK,EAAE,CACb,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CACnG,CAAC;YAEF,gCAAgC;YAChC,OAAO,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,QAAiC;QAC3D,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,EAAE,CAAC;QAChD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkC,CAAC;QACnE,MAAM,gBAAgB,GAAG,IAAA,iCAAc,GAAE,CAAC;QAC1C,MAAM,gBAAgB,GAAG,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,gBAAgB,EAAE,CAAC;QAEhG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC5C,gBAAgB,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,gBAAgB,EAAE,EAAE;gBACnD,GAAG,MAAM;gBACT,WAAW,EAAE,gBAAgB;aAC7B,CAAC,CAAC;QACJ,CAAC;QACD,OAAO,gBAAgB,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,OAAO;QACb,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC1B,CAAC;IACF,CAAC;CACD;AAlOD,gEAkOC;AAED;;;GAGG;AACH,MAAa,gBAAgB;IAC5B;;OAEG;IACI,MAAM,CAAC,SAAS,CAAC,WAAgD;QACvE,MAAM,aAAa,GAAG,IAAI,GAAG,EAAqC,CAAC;QAEnE,2DAA2D;QAC3D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAmD,CAAC;QAEnF,KAAK,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;YACpD,+FAA+F;YAC/F,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5C,MAAM,aAAa,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;YAE7F,IAAI,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACZ,KAAK,GAAG,EAAE,CAAC;gBACX,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,IAAI,eAAe,EAAE,CAAC;YAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,uBAAuB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;YAC9E,aAAa,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,aAAa,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,uBAAuB,CACrC,aAAqB,EACrB,aAAsD;QAEtD,MAAM,gBAAgB,GAA6C;YAClE,OAAO,EAAE,EAAE;SACX,CAAC;QACF,IAAI,mBAAmB,GAAG,CAAC,CAAC;QAC5B,IAAI,aAAiC,CAAC;QACtC,IAAI,KAAiC,CAAC;QACtC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAgC,CAAC;QAC7D,MAAM,aAAa,GAAG,IAAI,GAAG,EAAsC,CAAC;QAEpE,0CAA0C;QAC1C,KAAK,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YACtD,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAChD,MAAM,WAAW,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEhF,wCAAwC;YACxC,MAAM,SAAS,GACd,MAAM,CAAC,WAAW,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;YAE5G,oDAAoD;YACpD,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;gBAC5B,gBAAgB,CAAC,IAAI,GAAG,SAAS,CAAC;YACnC,CAAC;iBAAM,IAAI,WAAW,IAAI,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7D,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;gBAC/E,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;oBACzB,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;gBACnD,CAAC;YACF,CAAC;YAED,sBAAsB;YACtB,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAE5E,mDAAmD;YACnD,IAAI,MAAM,CAAC,MAAM,KAAK,kCAAuB,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzE,IAAI,CAAC,aAAa,IAAI,SAAS,GAAG,mBAAmB,EAAE,CAAC;oBACvD,mBAAmB,GAAG,SAAS,CAAC;oBAChC,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;gBAChC,CAAC;YACF,CAAC;YAED,oBAAoB;YACpB,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC5B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACtB,CAAC;QACF,CAAC;QAED,qFAAqF;QACrF,MAAM,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC;QAEnE,iEAAiE;QACjE,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,qDAAqD;YACrD,KAAK,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;gBACtD,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;oBACxC,aAAa,CAAC,GAAG,CAAC,cAAc,EAAE;wBACjC,WAAW,EAAE,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;wBACvE,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;qBACnB,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;QACF,CAAC;QAED,2BAA2B;QAC3B,MAAM,gBAAgB,GAA8B;YACnD,aAAa;YACb,MAAM,EAAE,gBAAgB;YACxB,WAAW,EAAE,gBAAgB;YAC7B,aAAa;YACb,KAAK;SACL,CAAC;QAEF,0CAA0C;QAC1C,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC5B,gBAAgB,CAAC,aAAa,GAAG,aAAa,CAAC;QAChD,CAAC;QAED,OAAO,gBAAgB,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,sBAAsB,CAAC,YAA+C;QACpF,MAAM,cAAc,GAAG;YACtB,kCAAuB,CAAC,KAAK;YAC7B,kCAAuB,CAAC,OAAO;YAC/B,kCAAuB,CAAC,OAAO;YAC/B,kCAAuB,CAAC,OAAO;YAC/B,kCAAuB,CAAC,OAAO;SAC/B,CAAC;QAEF,KAAK,MAAM,cAAc,IAAI,cAAc,EAAE,CAAC;YAC7C,IAAI,YAAY,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,cAAc,CAAE,GAAG,CAAC,EAAE,CAAC;gBAC/E,OAAO,cAAc,CAAC;YACvB,CAAC;QACF,CAAC;QAED,OAAO,kCAAuB,CAAC,OAAO,CAAC;IACxC,CAAC;CACD;AA5ID,4CA4IC;AAED,uDAAuD;AACvD,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,MAAM,CAAC,CAAC;AAC/D,QAAA,oBAAoB,GAAG,IAAI,0BAA0B,CAAC,UAAU,CAAC,CAAC"}

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

@@ -0,0 +1,68 @@
+/**
+ * Component Status Error Types
+ *
+ * This module defines specific error types for the component status system,
+ * providing better diagnostics and error handling capabilities.
+ */
+/**
+ * Base error class for component status system
+ */
+export declare class ComponentStatusError extends Error {
+    readonly statusCode: number;
+    readonly timestamp: Date;
+    constructor(message: string, statusCode?: number);
+}
+/**
+ * Error thrown when cross-thread status collection times out
+ */
+export declare class CrossThreadTimeoutError extends ComponentStatusError {
+    readonly requestId: number;
+    readonly timeoutMs: number;
+    readonly collectedCount: number;
+    constructor(requestId: number, timeoutMs: number, collectedCount: number);
+}
+/**
+ * Error thrown when ITC (Inter-Thread Communication) fails
+ */
+export declare class ITCError extends ComponentStatusError {
+    readonly operation: string;
+    readonly cause?: Error;
+    constructor(operation: string, cause?: Error);
+}
+/**
+ * Error thrown when component status aggregation fails
+ */
+export declare class AggregationError extends ComponentStatusError {
+    readonly componentCount: number;
+    readonly cause?: Error;
+    constructor(componentCount: number, cause?: Error);
+}
+/**
+ * Error thrown when a component status operation fails
+ */
+export declare class ComponentStatusOperationError extends ComponentStatusError {
+    readonly componentName: string;
+    readonly operation: string;
+    constructor(componentName: string, operation: string, message: string);
+}
+/**
+ * Information about cross-thread collection results
+ */
+export interface CrossThreadCollectionResult {
+    success: boolean;
+    collectedFromThreads: number;
+    expectedThreads?: number;
+    timedOutThreads: number[];
+    errors: Error[];
+}
+/**
+ * Error thrown with detailed cross-thread collection diagnostics
+ */
+export declare class CrossThreadCollectionError extends ComponentStatusError {
+    readonly result: CrossThreadCollectionResult;
+    constructor(result: CrossThreadCollectionResult);
+    /**
+     * Get detailed diagnostic information
+     */
+    getDiagnostics(): string;
+}

package/dist/components/status/errors.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Component Status Error Types
+ *
+ * This module defines specific error types for the component status system,
+ * providing better diagnostics and error handling capabilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrossThreadCollectionError = exports.ComponentStatusOperationError = exports.AggregationError = exports.ITCError = exports.CrossThreadTimeoutError = exports.ComponentStatusError = void 0;
+const commonErrors_js_1 = require("../../utility/errors/commonErrors.js");
+/**
+ * Base error class for component status system
+ */
+class ComponentStatusError extends Error {
+    statusCode;
+    timestamp;
+    constructor(message, statusCode = commonErrors_js_1.HTTP_STATUS_CODES.INTERNAL_SERVER_ERROR) {
+        super(message);
+        this.name = 'ComponentStatusError';
+        this.statusCode = statusCode;
+        this.timestamp = new Date();
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+exports.ComponentStatusError = ComponentStatusError;
+/**
+ * Error thrown when cross-thread status collection times out
+ */
+class CrossThreadTimeoutError extends ComponentStatusError {
+    requestId;
+    timeoutMs;
+    collectedCount;
+    constructor(requestId, timeoutMs, collectedCount) {
+        super(`Component status collection timeout after ${timeoutMs}ms. ` +
+            `Collected ${collectedCount} responses for request ${requestId}.`, commonErrors_js_1.HTTP_STATUS_CODES.GATEWAY_TIMEOUT);
+        this.name = 'CrossThreadTimeoutError';
+        this.requestId = requestId;
+        this.timeoutMs = timeoutMs;
+        this.collectedCount = collectedCount;
+    }
+}
+exports.CrossThreadTimeoutError = CrossThreadTimeoutError;
+/**
+ * Error thrown when ITC (Inter-Thread Communication) fails
+ */
+class ITCError extends ComponentStatusError {
+    operation;
+    cause;
+    constructor(operation, cause) {
+        super(`Inter-thread communication failed during ${operation}: ${cause?.message || 'Unknown error'}`, commonErrors_js_1.HTTP_STATUS_CODES.SERVICE_UNAVAILABLE);
+        this.name = 'ITCError';
+        this.operation = operation;
+        this.cause = cause;
+    }
+}
+exports.ITCError = ITCError;
+/**
+ * Error thrown when component status aggregation fails
+ */
+class AggregationError extends ComponentStatusError {
+    componentCount;
+    cause;
+    constructor(componentCount, cause) {
+        super(`Failed to aggregate status for ${componentCount} components: ${cause?.message || 'Unknown error'}`, commonErrors_js_1.HTTP_STATUS_CODES.INTERNAL_SERVER_ERROR);
+        this.name = 'AggregationError';
+        this.componentCount = componentCount;
+        this.cause = cause;
+    }
+}
+exports.AggregationError = AggregationError;
+/**
+ * Error thrown when a component status operation fails
+ */
+class ComponentStatusOperationError extends ComponentStatusError {
+    componentName;
+    operation;
+    constructor(componentName, operation, message) {
+        super(`Component '${componentName}' ${operation} failed: ${message}`, commonErrors_js_1.HTTP_STATUS_CODES.INTERNAL_SERVER_ERROR);
+        this.name = 'ComponentStatusOperationError';
+        this.componentName = componentName;
+        this.operation = operation;
+    }
+}
+exports.ComponentStatusOperationError = ComponentStatusOperationError;
+/**
+ * Error thrown with detailed cross-thread collection diagnostics
+ */
+class CrossThreadCollectionError extends ComponentStatusError {
+    result;
+    constructor(result) {
+        const message = result.success
+            ? `Partial collection success: ${result.collectedFromThreads} threads responded` +
+                (result.timedOutThreads.length > 0 ? `, ${result.timedOutThreads.length} timed out` : '')
+            : `Collection failed: ${result.errors.map((e) => e.message).join(', ')}`;
+        super(message, commonErrors_js_1.HTTP_STATUS_CODES.OK); // 200 - partial success is still success
+        this.name = 'CrossThreadCollectionError';
+        this.result = result;
+    }
+    /**
+     * Get detailed diagnostic information
+     */
+    getDiagnostics() {
+        const lines = [
+            `Cross-thread collection ${this.result.success ? 'partially succeeded' : 'failed'}`,
+            `Threads responded: ${this.result.collectedFromThreads}`,
+        ];
+        if (this.result.expectedThreads) {
+            lines.push(`Expected threads: ${this.result.expectedThreads}`);
+        }
+        if (this.result.timedOutThreads.length > 0) {
+            lines.push(`Timed out threads: ${this.result.timedOutThreads.join(', ')}`);
+        }
+        if (this.result.errors.length > 0) {
+            lines.push('Errors:');
+            this.result.errors.forEach((error, index) => {
+                lines.push(`  ${index + 1}. ${error.name}: ${error.message}`);
+            });
+        }
+        return lines.join('\n');
+    }
+}
+exports.CrossThreadCollectionError = CrossThreadCollectionError;
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * Component Status System
+ *
+ * A simple, clean API for tracking component health across Harper's distributed architecture.
+ *
+ * @example Basic usage:
+ * ```typescript
+ * import { statusForComponent, STATUS } from './components/status/index.ts';
+ *
+ * // Report component status
+ * statusForComponent('my-service').healthy('Service initialized');
+ * statusForComponent('database').error('Connection timeout', error);
+ * statusForComponent('cache').warning('High memory usage');
+ *
+ * // Get component status
+ * const status = statusForComponent('my-service').get();
+ * ```
+ *
+ * @example Lifecycle usage (for component loader):
+ * ```typescript
+ * import { lifecycle } from './components/status/index.ts';
+ *
+ * lifecycle.loading('my-component');
+ * // ... load component ...
+ * lifecycle.loaded('my-component', 'Successfully initialized');
+ * // or
+ * lifecycle.failed('my-component', error);
+ * ```
+ */
+export { statusForComponent, // Main API for reporting status
+lifecycle, // Component loader lifecycle hooks
+reset, // Reset all statuses (testing)
+STATUS, } from './api.ts';
+export type { ComponentStatusLevel, AggregatedComponentStatus, ComponentStatus } from './api.ts';
+export * as internal from './internal.ts';

package/dist/components/status/index.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Component Status System
+ *
+ * A simple, clean API for tracking component health across Harper's distributed architecture.
+ *
+ * @example Basic usage:
+ * ```typescript
+ * import { statusForComponent, STATUS } from './components/status/index.ts';
+ *
+ * // Report component status
+ * statusForComponent('my-service').healthy('Service initialized');
+ * statusForComponent('database').error('Connection timeout', error);
+ * statusForComponent('cache').warning('High memory usage');
+ *
+ * // Get component status
+ * const status = statusForComponent('my-service').get();
+ * ```
+ *
+ * @example Lifecycle usage (for component loader):
+ * ```typescript
+ * import { lifecycle } from './components/status/index.ts';
+ *
+ * lifecycle.loading('my-component');
+ * // ... load component ...
+ * lifecycle.loaded('my-component', 'Successfully initialized');
+ * // or
+ * lifecycle.failed('my-component', error);
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internal = exports.STATUS = exports.reset = exports.lifecycle = exports.statusForComponent = void 0;
+// Public API - clean and simple
+var api_ts_1 = require("./api.js");
+Object.defineProperty(exports, "statusForComponent", { enumerable: true, get: function () { return api_ts_1.statusForComponent; } });
+Object.defineProperty(exports, "lifecycle", { enumerable: true, get: function () { return api_ts_1.lifecycle; } });
+Object.defineProperty(exports, "reset", { enumerable: true, get: function () { return api_ts_1.reset; } });
+Object.defineProperty(exports, "STATUS", { enumerable: true, get: function () { return api_ts_1.STATUS; } });
+// Internal exports for Harper core only
+// These should NOT be used by components
+exports.internal = __importStar(require("./internal.js"));
+//# sourceMappingURL=index.js.map