cmp-standards 2.7.0 → 2.8.0-alpha

package/dist/events/EventBus.js

@@ -0,0 +1,200 @@
+/**
+ * @file EventBus - In-memory event bus for cmp-standards v2.8
+ * @description Decoupled event-driven architecture for expert panel orchestration
+ *
+ * Features:
+ * - Type-safe event publishing and subscribing
+ * - Parallel handler execution with Promise.allSettled
+ * - Event history for debugging
+ * - Handler timeout protection
+ * - Correlation ID tracking for request tracing
+ */
+import { createEventMetadata, } from './types.js';
+const DEFAULT_CONFIG = {
+    historyLimit: 100,
+    handlerTimeout: 5000,
+    debug: false,
+};
+// =============================================================================
+// EventBus Implementation
+// =============================================================================
+export class EventBus {
+    handlers = {};
+    history = [];
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Subscribe to an event type
+     * @returns Unsubscribe function
+     */
+    subscribe(eventType, handler) {
+        if (!this.handlers[eventType]) {
+            this.handlers[eventType] = [];
+        }
+        // Type assertion needed due to TypeScript limitations with mapped types
+        const handlers = this.handlers[eventType];
+        handlers.push(handler);
+        if (this.config.debug) {
+            console.log(`[EventBus] Subscribed to ${eventType}`);
+        }
+        // Return unsubscribe function
+        return () => {
+            const index = handlers.indexOf(handler);
+            if (index > -1) {
+                handlers.splice(index, 1);
+                if (this.config.debug) {
+                    console.log(`[EventBus] Unsubscribed from ${eventType}`);
+                }
+            }
+        };
+    }
+    /**
+     * Publish an event to all subscribers
+     * Handlers are executed in parallel with timeout protection
+     */
+    async publish(event) {
+        const startTime = Date.now();
+        // Add to history
+        this.addToHistory(event);
+        const handlers = this.handlers[event.type];
+        if (!handlers || handlers.length === 0) {
+            if (this.config.debug) {
+                console.log(`[EventBus] No handlers for ${event.type}`);
+            }
+            return {
+                success: true,
+                handlerResults: [],
+                duration: Date.now() - startTime,
+            };
+        }
+        if (this.config.debug) {
+            console.log(`[EventBus] Publishing ${event.type} to ${handlers.length} handlers`);
+        }
+        // Execute all handlers in parallel with timeout
+        const handlerPromises = handlers.map(handler => this.executeWithTimeout(handler, event));
+        const results = await Promise.allSettled(handlerPromises);
+        const failedCount = results.filter(r => r.status === 'rejected').length;
+        const duration = Date.now() - startTime;
+        if (this.config.debug) {
+            console.log(`[EventBus] ${event.type} completed in ${duration}ms ` +
+                `(${handlers.length - failedCount}/${handlers.length} succeeded)`);
+        }
+        return {
+            success: failedCount === 0,
+            handlerResults: results,
+            duration,
+        };
+    }
+    /**
+     * Publish and wait for all handlers, throwing on any failure
+     */
+    async publishStrict(event) {
+        const result = await this.publish(event);
+        if (!result.success) {
+            const errors = result.handlerResults
+                .filter((r) => r.status === 'rejected')
+                .map(r => r.reason);
+            throw new AggregateError(errors, `Event ${event.type} failed with ${errors.length} handler errors`);
+        }
+    }
+    /**
+     * Execute handler with timeout protection
+     */
+    async executeWithTimeout(handler, event) {
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                reject(new Error(`Handler timeout after ${this.config.handlerTimeout}ms`));
+            }, this.config.handlerTimeout);
+            Promise.resolve(handler(event))
+                .then(() => {
+                clearTimeout(timeoutId);
+                resolve();
+            })
+                .catch(error => {
+                clearTimeout(timeoutId);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Add event to history with limit enforcement
+     */
+    addToHistory(event) {
+        this.history.push(event);
+        if (this.history.length > this.config.historyLimit) {
+            this.history.shift();
+        }
+    }
+    /**
+     * Get event history, optionally filtered by type
+     */
+    getHistory(type) {
+        if (!type)
+            return [...this.history];
+        return this.history.filter(e => e.type === type);
+    }
+    /**
+     * Get events by correlation ID (for request tracing)
+     */
+    getByCorrelationId(correlationId) {
+        return this.history.filter(e => e.metadata.correlationId === correlationId);
+    }
+    /**
+     * Clear all handlers and history
+     */
+    clear() {
+        this.handlers = {};
+        this.history = [];
+    }
+    /**
+     * Get handler count for a specific event type
+     */
+    getHandlerCount(type) {
+        return this.handlers[type]?.length ?? 0;
+    }
+    /**
+     * Check if there are any handlers for an event type
+     */
+    hasHandlers(type) {
+        return this.getHandlerCount(type) > 0;
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let globalEventBus = null;
+/**
+ * Get or create the global EventBus instance
+ */
+export function getEventBus(config) {
+    if (!globalEventBus) {
+        globalEventBus = new EventBus(config);
+    }
+    return globalEventBus;
+}
+/**
+ * Reset the global EventBus (useful for testing)
+ */
+export function resetEventBus() {
+    if (globalEventBus) {
+        globalEventBus.clear();
+    }
+    globalEventBus = null;
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Create and publish an event in one call
+ */
+export async function emitEvent(eventData, source, correlationId) {
+    const bus = getEventBus();
+    const event = {
+        ...eventData,
+        metadata: createEventMetadata(source, correlationId),
+    };
+    await bus.publish(event);
+}
+//# sourceMappingURL=EventBus.js.map

package/dist/events/EventBus.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file Events Module - cmp-standards v2.8
+ * @description Event-driven architecture for expert panel orchestration
+ */
+export * from './types.js';
+export { EventBus, EventBusConfig, getEventBus, resetEventBus, emitEvent, } from './EventBus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,YAAY,CAAA;AAG1B,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,eAAe,CAAA"}

package/dist/events/index.js

@@ -0,0 +1,9 @@
+/**
+ * @file Events Module - cmp-standards v2.8
+ * @description Event-driven architecture for expert panel orchestration
+ */
+// Types
+export * from './types.js';
+// EventBus
+export { EventBus, getEventBus, resetEventBus, emitEvent, } from './EventBus.js';
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAA;AAE1B,WAAW;AACX,OAAO,EACL,QAAQ,EAER,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,eAAe,CAAA"}