dartmind 17.0.0

package/dist/v10/event/EventBus.js

@@ -0,0 +1,440 @@
+/**
+ * FlutterAI v10 - EventBus
+ *
+ * Central event dispatching and subscription system.
+ * Provides typed events, wildcards, priority handling, and async support.
+ *
+ * Features:
+ * - Typed event emission and subscription
+ * - Wildcard pattern matching
+ * - Priority-based handler ordering
+ * - Async handler support
+ * - Once handlers (auto-unsubscribe)
+ * - Event namespacing
+ * - Handler timeout protection
+ *
+ * @module v10/event/EventBus
+ */
+import { EventEmitter } from 'events';
+// ============================================================================
+// Default Configuration
+// ============================================================================
+const DEFAULT_CONFIG = {
+    handlerTimeout: 5000,
+    maxHandlersPerEvent: 100,
+    enableWildcards: true,
+    continueOnError: true
+};
+// ============================================================================
+// EventBus Implementation
+// ============================================================================
+export class EventBus extends EventEmitter {
+    config;
+    subscriptions = new Map();
+    patternIndex = new Map();
+    nextId = 1;
+    stats = {
+        totalEvents: 0,
+        totalHandlerCalls: 0,
+        activeSubscriptions: 0,
+        handlerErrors: 0,
+        handlerTimeouts: 0,
+        eventCounts: new Map()
+    };
+    constructor(config) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // --------------------------------------------------------------------------
+    // Subscription
+    // --------------------------------------------------------------------------
+    /**
+     * Subscribe to an event
+     */
+    subscribe(pattern, handler, options) {
+        const id = `sub_${this.nextId++}`;
+        const priority = options?.priority ?? 0;
+        const once = options?.once ?? false;
+        // Check max handlers
+        const existingCount = this.getHandlerCount(pattern);
+        if (existingCount >= this.config.maxHandlersPerEvent) {
+            throw new Error(`Maximum handlers (${this.config.maxHandlersPerEvent}) reached for pattern '${pattern}'`);
+        }
+        const subscription = {
+            id,
+            pattern,
+            handler: handler,
+            priority,
+            once,
+            createdAt: new Date(),
+            callCount: 0
+        };
+        this.subscriptions.set(id, subscription);
+        // Update pattern index
+        if (!this.patternIndex.has(pattern)) {
+            this.patternIndex.set(pattern, new Set());
+        }
+        this.patternIndex.get(pattern).add(id);
+        this.stats.activeSubscriptions++;
+        this.emit('event', { type: 'subscribed', subscriptionId: id, pattern });
+        return id;
+    }
+    /**
+     * Subscribe to an event (once only)
+     */
+    subscribeOnce(pattern, handler, priority) {
+        return this.subscribe(pattern, handler, { priority, once: true });
+    }
+    /**
+     * Unsubscribe by subscription ID
+     */
+    unsubscribe(subscriptionId) {
+        const subscription = this.subscriptions.get(subscriptionId);
+        if (!subscription) {
+            return false;
+        }
+        // Remove from pattern index
+        this.patternIndex.get(subscription.pattern)?.delete(subscriptionId);
+        if (this.patternIndex.get(subscription.pattern)?.size === 0) {
+            this.patternIndex.delete(subscription.pattern);
+        }
+        this.subscriptions.delete(subscriptionId);
+        this.stats.activeSubscriptions--;
+        this.emit('event', { type: 'unsubscribed', subscriptionId, pattern: subscription.pattern });
+        return true;
+    }
+    /**
+     * Unsubscribe all handlers for a pattern
+     */
+    unsubscribeAll(pattern) {
+        const subscriptionIds = this.patternIndex.get(pattern);
+        if (!subscriptionIds) {
+            return 0;
+        }
+        let count = 0;
+        for (const id of subscriptionIds) {
+            if (this.unsubscribe(id)) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Check if there are subscribers for an event
+     */
+    hasSubscribers(event) {
+        return this.getMatchingSubscriptions(event).length > 0;
+    }
+    /**
+     * Get count of handlers for a pattern
+     */
+    getHandlerCount(pattern) {
+        return this.patternIndex.get(pattern)?.size ?? 0;
+    }
+    // --------------------------------------------------------------------------
+    // Emission
+    // --------------------------------------------------------------------------
+    /**
+     * Emit an event
+     */
+    async publish(event, data, options) {
+        const meta = {
+            event,
+            timestamp: new Date(),
+            source: options?.source ?? this.config.defaultSource,
+            correlationId: options?.correlationId
+        };
+        // Get matching subscriptions sorted by priority
+        const subscriptions = this.getMatchingSubscriptions(event);
+        subscriptions.sort((a, b) => b.priority - a.priority);
+        // Update stats
+        this.stats.totalEvents++;
+        this.stats.eventCounts.set(event, (this.stats.eventCounts.get(event) ?? 0) + 1);
+        const toRemove = [];
+        const timeout = options?.timeout ?? this.config.handlerTimeout;
+        // Execute handlers
+        for (const subscription of subscriptions) {
+            try {
+                this.stats.totalHandlerCalls++;
+                subscription.callCount++;
+                if (options?.waitForHandlers !== false) {
+                    await this.executeHandler(subscription, data, meta, timeout);
+                }
+                else {
+                    this.executeHandler(subscription, data, meta, timeout).catch(() => { });
+                }
+                if (subscription.once) {
+                    toRemove.push(subscription.id);
+                }
+            }
+            catch (error) {
+                this.stats.handlerErrors++;
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                this.emit('event', { type: 'handler_error', event, subscriptionId: subscription.id, error: errorMsg });
+                if (!this.config.continueOnError) {
+                    throw error;
+                }
+            }
+        }
+        // Remove once handlers
+        for (const id of toRemove) {
+            this.unsubscribe(id);
+        }
+        this.emit('event', { type: 'emitted', event, handlerCount: subscriptions.length });
+    }
+    /**
+     * Emit an event synchronously (fire and forget)
+     */
+    publishSync(event, data, options) {
+        this.publish(event, data, { ...options, waitForHandlers: false }).catch(() => { });
+    }
+    /**
+     * Execute a handler with timeout protection
+     */
+    async executeHandler(subscription, data, meta, timeout) {
+        const handler = subscription.handler;
+        const result = handler(data, meta);
+        if (result instanceof Promise) {
+            let timeoutId;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => {
+                    this.stats.handlerTimeouts++;
+                    this.emit('event', { type: 'handler_timeout', event: meta.event, subscriptionId: subscription.id });
+                    reject(new Error(`Handler timeout for subscription ${subscription.id}`));
+                }, timeout);
+            });
+            try {
+                await Promise.race([result, timeoutPromise]);
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Pattern Matching
+    // --------------------------------------------------------------------------
+    /**
+     * Get subscriptions matching an event
+     */
+    getMatchingSubscriptions(event) {
+        const matching = [];
+        for (const [pattern, subscriptionIds] of this.patternIndex) {
+            if (this.matchesPattern(event, pattern)) {
+                for (const id of subscriptionIds) {
+                    const subscription = this.subscriptions.get(id);
+                    if (subscription) {
+                        matching.push(subscription);
+                    }
+                }
+            }
+        }
+        return matching;
+    }
+    /**
+     * Check if an event matches a pattern
+     */
+    matchesPattern(event, pattern) {
+        if (!this.config.enableWildcards) {
+            return event === pattern;
+        }
+        // Exact match
+        if (event === pattern) {
+            return true;
+        }
+        // Wildcard patterns
+        if (pattern === '*') {
+            return true;
+        }
+        // ** matches any number of segments
+        if (pattern === '**') {
+            return true;
+        }
+        // Segment-based matching
+        const eventParts = event.split('.');
+        const patternParts = pattern.split('.');
+        return this.matchSegments(eventParts, patternParts);
+    }
+    /**
+     * Match event segments against pattern segments
+     */
+    matchSegments(eventParts, patternParts) {
+        let eventIdx = 0;
+        let patternIdx = 0;
+        while (patternIdx < patternParts.length) {
+            const patternPart = patternParts[patternIdx];
+            if (patternPart === '**') {
+                // ** matches zero or more segments
+                if (patternIdx === patternParts.length - 1) {
+                    // ** at end matches everything
+                    return true;
+                }
+                // Try to match remaining pattern
+                const nextPatternPart = patternParts[patternIdx + 1];
+                while (eventIdx < eventParts.length) {
+                    if (eventParts[eventIdx] === nextPatternPart || nextPatternPart === '*') {
+                        break;
+                    }
+                    eventIdx++;
+                }
+                patternIdx++;
+                continue;
+            }
+            if (eventIdx >= eventParts.length) {
+                return false;
+            }
+            if (patternPart === '*') {
+                // * matches exactly one segment
+                eventIdx++;
+                patternIdx++;
+                continue;
+            }
+            if (eventParts[eventIdx] !== patternPart) {
+                return false;
+            }
+            eventIdx++;
+            patternIdx++;
+        }
+        return eventIdx === eventParts.length;
+    }
+    // --------------------------------------------------------------------------
+    // Namespacing
+    // --------------------------------------------------------------------------
+    /**
+     * Create a namespaced event bus
+     */
+    namespace(prefix) {
+        return new NamespacedEventBus(this, prefix);
+    }
+    // --------------------------------------------------------------------------
+    // Inspection
+    // --------------------------------------------------------------------------
+    /**
+     * Get all subscriptions
+     */
+    getSubscriptions() {
+        return Array.from(this.subscriptions.values()).map(s => ({ ...s }));
+    }
+    /**
+     * Get subscription by ID
+     */
+    getSubscription(id) {
+        const sub = this.subscriptions.get(id);
+        return sub ? { ...sub } : undefined;
+    }
+    /**
+     * Get all registered patterns
+     */
+    getPatterns() {
+        return Array.from(this.patternIndex.keys());
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            eventCounts: new Map(this.stats.eventCounts)
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Lifecycle
+    // --------------------------------------------------------------------------
+    /**
+     * Clear all subscriptions
+     */
+    clear() {
+        this.subscriptions.clear();
+        this.patternIndex.clear();
+        this.stats.activeSubscriptions = 0;
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.stats = {
+            totalEvents: 0,
+            totalHandlerCalls: 0,
+            activeSubscriptions: this.subscriptions.size,
+            handlerErrors: 0,
+            handlerTimeouts: 0,
+            eventCounts: new Map()
+        };
+    }
+}
+// ============================================================================
+// NamespacedEventBus
+// ============================================================================
+/**
+ * A namespaced wrapper around EventBus
+ */
+export class NamespacedEventBus {
+    bus;
+    prefix;
+    subscriptionIds = new Set();
+    constructor(bus, prefix) {
+        this.bus = bus;
+        this.prefix = prefix.endsWith('.') ? prefix : `${prefix}.`;
+    }
+    /**
+     * Get the full event name with namespace prefix
+     */
+    getFullEvent(event) {
+        return `${this.prefix}${event}`;
+    }
+    /**
+     * Subscribe to a namespaced event
+     */
+    subscribe(event, handler, options) {
+        const id = this.bus.subscribe(this.getFullEvent(event), handler, options);
+        this.subscriptionIds.add(id);
+        return id;
+    }
+    /**
+     * Subscribe once to a namespaced event
+     */
+    subscribeOnce(event, handler, priority) {
+        const id = this.bus.subscribeOnce(this.getFullEvent(event), handler, priority);
+        this.subscriptionIds.add(id);
+        return id;
+    }
+    /**
+     * Unsubscribe
+     */
+    unsubscribe(subscriptionId) {
+        this.subscriptionIds.delete(subscriptionId);
+        return this.bus.unsubscribe(subscriptionId);
+    }
+    /**
+     * Publish a namespaced event
+     */
+    async publish(event, data, options) {
+        return this.bus.publish(this.getFullEvent(event), data, options);
+    }
+    /**
+     * Publish synchronously
+     */
+    publishSync(event, data, options) {
+        this.bus.publishSync(this.getFullEvent(event), data, options);
+    }
+    /**
+     * Clear all subscriptions in this namespace
+     */
+    clear() {
+        for (const id of this.subscriptionIds) {
+            this.bus.unsubscribe(id);
+        }
+        this.subscriptionIds.clear();
+    }
+    /**
+     * Get the namespace prefix
+     */
+    getPrefix() {
+        return this.prefix;
+    }
+}
+// ============================================================================
+// Export
+// ============================================================================
+export default EventBus;
+//# sourceMappingURL=EventBus.js.map

package/dist/v10/event/EventBus.js.map

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

package/dist/v10/event/EventStore.d.ts

@@ -0,0 +1,236 @@
+/**
+ * FlutterAI v10 - EventStore
+ *
+ * Event persistence and replay capabilities.
+ * Stores events for auditing, debugging, and replay scenarios.
+ *
+ * Features:
+ * - Event persistence with configurable retention
+ * - Event replay by time range or filter
+ * - Event querying and filtering
+ * - Snapshot support
+ * - Size-based eviction
+ *
+ * @module v10/event/EventStore
+ */
+import { EventEmitter } from 'events';
+import type { EventMeta } from './EventBus.js';
+export interface StoredEvent<T = unknown> {
+    /** Unique event ID */
+    id: string;
+    /** Event name */
+    event: string;
+    /** Event data */
+    data: T;
+    /** Event metadata */
+    meta: EventMeta;
+    /** Storage timestamp */
+    storedAt: Date;
+    /** Event sequence number */
+    sequence: number;
+}
+export interface EventFilter {
+    /** Filter by event name (exact or pattern) */
+    event?: string;
+    /** Filter by source */
+    source?: string;
+    /** Filter by correlation ID */
+    correlationId?: string;
+    /** Filter by time range (start) */
+    from?: Date;
+    /** Filter by time range (end) */
+    to?: Date;
+    /** Filter by sequence range (start) */
+    fromSequence?: number;
+    /** Filter by sequence range (end) */
+    toSequence?: number;
+    /** Custom filter function */
+    predicate?: (event: StoredEvent) => boolean;
+}
+export interface EventQuery extends EventFilter {
+    /** Maximum results to return */
+    limit?: number;
+    /** Skip first N results */
+    offset?: number;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+}
+export interface EventStoreConfig {
+    /** Maximum events to store. Default: 10000 */
+    maxEvents: number;
+    /** Event retention period in ms. Default: 86400000 (24h) */
+    retentionPeriod: number;
+    /** Enable automatic cleanup. Default: true */
+    autoCleanup: boolean;
+    /** Cleanup interval in ms. Default: 60000 (1 min) */
+    cleanupInterval: number;
+    /** Enable event compression. Default: false */
+    compress: boolean;
+}
+export interface Snapshot {
+    /** Snapshot ID */
+    id: string;
+    /** Snapshot name */
+    name: string;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last sequence number at snapshot time */
+    lastSequence: number;
+    /** Number of events in snapshot */
+    eventCount: number;
+    /** Snapshot data */
+    events: StoredEvent[];
+}
+export interface EventStoreStats {
+    /** Total events stored */
+    totalEvents: number;
+    /** Total events ever recorded */
+    totalEventsRecorded: number;
+    /** Events evicted */
+    evictedEvents: number;
+    /** Current sequence number */
+    currentSequence: number;
+    /** Oldest event timestamp */
+    oldestEvent?: Date;
+    /** Newest event timestamp */
+    newestEvent?: Date;
+    /** Number of snapshots */
+    snapshotCount: number;
+}
+export type EventStoreEventType = 'event_stored' | 'events_evicted' | 'snapshot_created' | 'snapshot_restored';
+export type EventStoreEvent = {
+    type: 'event_stored';
+    eventId: string;
+    event: string;
+    sequence: number;
+} | {
+    type: 'events_evicted';
+    count: number;
+    reason: 'size' | 'retention';
+} | {
+    type: 'snapshot_created';
+    snapshotId: string;
+    eventCount: number;
+} | {
+    type: 'snapshot_restored';
+    snapshotId: string;
+    eventCount: number;
+};
+export declare class EventStore extends EventEmitter {
+    private config;
+    private events;
+    private eventIndex;
+    private sequenceIndex;
+    private nextId;
+    private sequence;
+    private snapshots;
+    private cleanupTimer;
+    private stats;
+    constructor(config?: Partial<EventStoreConfig>);
+    /**
+     * Store an event
+     */
+    store<T = unknown>(event: string, data: T, meta: EventMeta): StoredEvent<T>;
+    /**
+     * Evict oldest events
+     */
+    private evictOldest;
+    /**
+     * Rebuild indices after eviction
+     */
+    private rebuildIndices;
+    /**
+     * Get an event by ID
+     */
+    get(id: string): StoredEvent | undefined;
+    /**
+     * Get an event by sequence number
+     */
+    getBySequence(sequence: number): StoredEvent | undefined;
+    /**
+     * Get the latest N events
+     */
+    getLatest(count: number): StoredEvent[];
+    /**
+     * Query events with filtering
+     */
+    query(query?: EventQuery): StoredEvent[];
+    /**
+     * Filter events
+     */
+    filter(filter: EventFilter): StoredEvent[];
+    /**
+     * Check if an event matches a filter
+     */
+    private matchesFilter;
+    /**
+     * Match event name against pattern
+     */
+    private matchesPattern;
+    /**
+     * Count events matching a filter
+     */
+    count(filter?: EventFilter): number;
+    /**
+     * Replay events through a handler
+     */
+    replay(handler: (event: StoredEvent) => void | Promise<void>, filter?: EventFilter): Promise<number>;
+    /**
+     * Replay events since a specific sequence
+     */
+    replaySince(sequence: number, handler: (event: StoredEvent) => void | Promise<void>): Promise<number>;
+    /**
+     * Create a snapshot of current events
+     */
+    createSnapshot(name: string): Snapshot;
+    /**
+     * Restore from a snapshot
+     */
+    restoreSnapshot(snapshotId: string): boolean;
+    /**
+     * Get snapshot by ID
+     */
+    getSnapshot(id: string): Snapshot | undefined;
+    /**
+     * List all snapshots
+     */
+    listSnapshots(): Array<Omit<Snapshot, 'events'>>;
+    /**
+     * Delete a snapshot
+     */
+    deleteSnapshot(id: string): boolean;
+    /**
+     * Start automatic cleanup
+     */
+    startCleanup(): void;
+    /**
+     * Stop automatic cleanup
+     */
+    stopCleanup(): void;
+    /**
+     * Clean up expired events
+     */
+    cleanup(): number;
+    /**
+     * Get store statistics
+     */
+    getStats(): EventStoreStats;
+    /**
+     * Get current sequence number
+     */
+    getCurrentSequence(): number;
+    /**
+     * Clear all events
+     */
+    clear(): void;
+    /**
+     * Clear all data including snapshots
+     */
+    reset(): void;
+    /**
+     * Shutdown the store
+     */
+    shutdown(): void;
+}
+export default EventStore;
+//# sourceMappingURL=EventStore.d.ts.map