@bloomneo/appkit 1.2.9

package/dist/event/strategies/memory.js

@@ -0,0 +1,331 @@
+/**
+ * Memory event strategy with Node.js EventEmitter and cleanup management
+ * @module @bloomneo/appkit/event
+ * @file src/event/strategies/memory.ts
+ *
+ * @llm-rule WHEN: No REDIS_URL environment variable - perfect for development and single-server apps
+ * @llm-rule AVOID: Production use across multiple servers - events don't work across processes
+ * @llm-rule NOTE: Fast local events, automatic cleanup, memory limits, great for development
+ */
+import { EventEmitter } from 'events';
+/**
+ * Memory event strategy with intelligent cleanup and limits
+ */
+export class MemoryStrategy {
+    config;
+    namespace;
+    emitter;
+    cleanupInterval = null;
+    listenerCounts = new Map();
+    /**
+     * Creates memory strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Event initialization without Redis URL - automatic fallback
+     * @llm-rule AVOID: Manual memory configuration - environment detection handles this
+     */
+    constructor(config, namespace) {
+        this.config = config;
+        this.namespace = namespace;
+        this.emitter = new EventEmitter();
+        // Set max listeners from config
+        this.emitter.setMaxListeners(config.memory?.maxListeners || 1000);
+        // Setup cleanup if garbage collection enabled
+        if (config.memory?.enableGC) {
+            this.setupCleanup();
+        }
+        if (this.config.environment.isDevelopment) {
+            console.log(`✅ [AppKit] Memory event strategy initialized (namespace: ${namespace}, maxListeners: ${this.emitter.getMaxListeners()})`);
+        }
+    }
+    /**
+     * Emits event via Node.js EventEmitter
+     * @llm-rule WHEN: Sending events within single process/server
+     * @llm-rule AVOID: Expecting cross-process delivery - memory events are local only
+     * @llm-rule NOTE: Instant delivery, no network latency, perfect for development
+     */
+    async emit(event, data) {
+        try {
+            // Emit via EventEmitter (synchronous but we return Promise for interface compatibility)
+            const result = this.emitter.emit(event, data);
+            // Update listener count tracking
+            this.updateListenerCount(event);
+            return result;
+        }
+        catch (error) {
+            console.error(`[AppKit] Memory emit error for event "${event}":`, error.message);
+            return false;
+        }
+    }
+    /**
+     * Adds event listener with automatic cleanup tracking
+     * @llm-rule WHEN: Listening to events within single process
+     * @llm-rule AVOID: Adding too many listeners - respects maxListeners limit
+     */
+    on(event, handler) {
+        try {
+            // Check listener limit
+            this.checkListenerLimit(event);
+            // Add listener
+            this.emitter.on(event, handler);
+            // Track listener count
+            this.incrementListenerCount(event);
+            if (this.config.environment.isDevelopment) {
+                console.log(`📥 [AppKit] Memory listener added for: ${event} (total: ${this.emitter.listenerCount(event)})`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Memory on error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Adds one-time event listener with automatic cleanup
+     * @llm-rule WHEN: Listening to events that should only fire once
+     * @llm-rule AVOID: Manual cleanup - this handles removal automatically
+     */
+    once(event, handler) {
+        try {
+            // Check listener limit
+            this.checkListenerLimit(event);
+            // Wrap handler to track cleanup
+            const onceWrapper = (data) => {
+                this.decrementListenerCount(event);
+                handler(data);
+            };
+            // Add one-time listener
+            this.emitter.once(event, onceWrapper);
+            // Track listener count
+            this.incrementListenerCount(event);
+            if (this.config.environment.isDevelopment) {
+                console.log(`📥 [AppKit] Memory once listener added for: ${event}`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Memory once error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Removes event listener(s) with cleanup tracking
+     * @llm-rule WHEN: Cleaning up event listeners to prevent memory leaks
+     * @llm-rule AVOID: Forgetting to remove listeners - memory strategy tracks everything
+     */
+    off(event, handler) {
+        try {
+            if (handler) {
+                // Remove specific handler
+                this.emitter.off(event, handler);
+                this.decrementListenerCount(event);
+            }
+            else {
+                // Remove all handlers for event
+                const count = this.emitter.listenerCount(event);
+                this.emitter.removeAllListeners(event);
+                this.listenerCounts.set(event, 0);
+                if (this.config.environment.isDevelopment && count > 0) {
+                    console.log(`📤 [AppKit] Memory removed ${count} listeners for: ${event}`);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Memory off error for event "${event}":`, error.message);
+        }
+    }
+    /**
+     * Gets current event listeners for debugging
+     * @llm-rule WHEN: Debugging event listeners or monitoring memory usage
+     * @llm-rule AVOID: Using for business logic - this is for debugging only
+     */
+    getListeners(event) {
+        if (event) {
+            return {
+                count: this.emitter.listenerCount(event),
+                events: [event],
+                maxListeners: this.emitter.getMaxListeners(),
+            };
+        }
+        // Get all events with listeners
+        const eventNames = this.emitter.eventNames();
+        const summary = eventNames.map(eventName => ({
+            event: eventName.toString(),
+            count: this.emitter.listenerCount(eventName),
+        }));
+        return {
+            totalEvents: eventNames.length,
+            totalListeners: summary.reduce((sum, item) => sum + item.count, 0),
+            maxListeners: this.emitter.getMaxListeners(),
+            events: summary,
+        };
+    }
+    /**
+     * Disconnects memory strategy gracefully
+     * @llm-rule WHEN: App shutdown or event cleanup
+     * @llm-rule AVOID: Memory leaks - always cleanup intervals and listeners
+     */
+    async disconnect() {
+        try {
+            // Stop cleanup interval
+            this.stopCleanup();
+            // Remove all listeners
+            this.emitter.removeAllListeners();
+            // Clear tracking
+            this.listenerCounts.clear();
+            if (this.config.environment.isDevelopment) {
+                console.log(`👋 [AppKit] Memory event strategy disconnected (namespace: ${this.namespace})`);
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Memory disconnect error:`, error.message);
+        }
+    }
+    // Private helper methods
+    /**
+     * Checks if adding listener would exceed limit
+     */
+    checkListenerLimit(event) {
+        const currentCount = this.emitter.listenerCount(event);
+        const maxListeners = this.emitter.getMaxListeners();
+        if (currentCount >= maxListeners) {
+            console.warn(`[AppKit] Memory event listener limit reached for "${event}" ` +
+                `(${currentCount}/${maxListeners}). Consider removing unused listeners.`);
+        }
+    }
+    /**
+     * Increments listener count tracking
+     */
+    incrementListenerCount(event) {
+        const current = this.listenerCounts.get(event) || 0;
+        this.listenerCounts.set(event, current + 1);
+    }
+    /**
+     * Decrements listener count tracking
+     */
+    decrementListenerCount(event) {
+        const current = this.listenerCounts.get(event) || 0;
+        const newCount = Math.max(0, current - 1);
+        if (newCount === 0) {
+            this.listenerCounts.delete(event);
+        }
+        else {
+            this.listenerCounts.set(event, newCount);
+        }
+    }
+    /**
+     * Updates listener count from actual emitter state
+     */
+    updateListenerCount(event) {
+        const actualCount = this.emitter.listenerCount(event);
+        if (actualCount === 0) {
+            this.listenerCounts.delete(event);
+        }
+        else {
+            this.listenerCounts.set(event, actualCount);
+        }
+    }
+    /**
+     * Sets up automatic cleanup interval
+     */
+    setupCleanup() {
+        const interval = this.config.memory?.checkInterval || 30000;
+        this.cleanupInterval = setInterval(() => {
+            this.performCleanup();
+        }, interval);
+        // Don't let interval keep process alive
+        if (this.cleanupInterval.unref) {
+            this.cleanupInterval.unref();
+        }
+    }
+    /**
+     * Stops cleanup interval
+     */
+    stopCleanup() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+    /**
+     * Performs memory cleanup and garbage collection
+     */
+    performCleanup() {
+        try {
+            // Sync listener counts with actual emitter state
+            this.syncListenerCounts();
+            // Clean up empty events
+            this.cleanupEmptyEvents();
+            // Log cleanup stats in development
+            if (this.config.environment.isDevelopment) {
+                const stats = this.getMemoryStats();
+                if (stats.totalListeners > 0) {
+                    console.log(`🧹 [AppKit] Memory cleanup completed: ` +
+                        `${stats.totalEvents} events, ${stats.totalListeners} listeners`);
+                }
+            }
+        }
+        catch (error) {
+            console.error(`[AppKit] Memory cleanup error:`, error.message);
+        }
+    }
+    /**
+     * Syncs tracking counts with actual emitter state
+     */
+    syncListenerCounts() {
+        // Check for events that no longer have listeners
+        for (const [event] of this.listenerCounts.entries()) {
+            const actualCount = this.emitter.listenerCount(event);
+            if (actualCount === 0) {
+                this.listenerCounts.delete(event);
+            }
+            else {
+                this.listenerCounts.set(event, actualCount);
+            }
+        }
+    }
+    /**
+     * Cleans up events with no listeners
+     */
+    cleanupEmptyEvents() {
+        const eventNames = this.emitter.eventNames();
+        for (const eventName of eventNames) {
+            const count = this.emitter.listenerCount(eventName);
+            if (count === 0) {
+                this.emitter.removeAllListeners(eventName);
+                this.listenerCounts.delete(eventName.toString());
+            }
+        }
+    }
+    /**
+     * Gets memory usage statistics
+     */
+    getMemoryStats() {
+        const eventNames = this.emitter.eventNames();
+        const totalListeners = eventNames.reduce((sum, eventName) => sum + this.emitter.listenerCount(eventName), 0);
+        return {
+            totalEvents: eventNames.length,
+            totalListeners,
+            maxListeners: this.emitter.getMaxListeners(),
+            memoryUsage: totalListeners / this.emitter.getMaxListeners(),
+        };
+    }
+    /**
+     * Gets detailed memory statistics for debugging
+     */
+    getDetailedStats() {
+        const eventNames = this.emitter.eventNames();
+        const events = eventNames.map(eventName => ({
+            event: eventName.toString(),
+            listeners: this.emitter.listenerCount(eventName),
+        }));
+        const totalListeners = events.reduce((sum, event) => sum + event.listeners, 0);
+        const maxListeners = this.emitter.getMaxListeners();
+        return {
+            strategy: 'memory',
+            namespace: this.namespace,
+            totalEvents: events.length,
+            totalListeners,
+            maxListeners,
+            memoryUsage: `${Math.round((totalListeners / maxListeners) * 100)}%`,
+            events: events.sort((a, b) => b.listeners - a.listeners), // Sort by listener count
+            cleanupEnabled: !!this.cleanupInterval,
+            lastCleanup: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/event/strategies/memory.js.map

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

package/dist/event/strategies/redis.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Redis event strategy with distributed pub/sub and automatic connection management
+ * @module @bloomneo/appkit/event
+ * @file src/event/strategies/redis.ts
+ *
+ * @llm-rule WHEN: App has REDIS_URL environment variable for distributed events across servers
+ * @llm-rule AVOID: Manual Redis setup - this handles connection, retry, and subscription management
+ * @llm-rule NOTE: Distributed events, automatic reconnection, pattern subscriptions, production-ready
+ */
+import type { EventStrategy, EventHandler } from '../event.js';
+import type { EventConfig } from '../defaults.js';
+/**
+ * Redis event strategy with distributed pub/sub and reliability features
+ */
+export declare class RedisStrategy implements EventStrategy {
+    private config;
+    private namespace;
+    private publisher;
+    private subscriber;
+    private connected;
+    private listeners;
+    private patternListeners;
+    /**
+     * Creates Redis strategy with direct environment access (like auth pattern)
+     * @llm-rule WHEN: Event initialization with REDIS_URL detected
+     * @llm-rule AVOID: Manual Redis configuration - environment detection handles this
+     */
+    constructor(config: EventConfig, namespace: string);
+    /**
+     * Connects to Redis with automatic retry and pub/sub setup
+     * @llm-rule WHEN: Event initialization or reconnection after failure
+     * @llm-rule AVOID: Manual connection management - this handles all Redis complexity
+     */
+    connect(): Promise<void>;
+    /**
+     * Sets up Redis event handlers for connection management
+     */
+    private setupEventHandlers;
+    /**
+     * Emits event via Redis pub/sub with automatic serialization
+     * @llm-rule WHEN: Sending events across multiple servers/processes
+     * @llm-rule AVOID: Manual Redis pub/sub - this handles serialization and namespacing
+     * @llm-rule NOTE: Events are distributed to all connected servers automatically
+     */
+    emit(event: string, data: any): Promise<boolean>;
+    /**
+     * Adds event listener with Redis subscription management
+     * @llm-rule WHEN: Listening to distributed events across servers
+     * @llm-rule AVOID: Manual Redis subscribe - this handles pattern matching and message routing
+     */
+    on(event: string, handler: EventHandler): void;
+    /**
+     * Adds one-time event listener with automatic cleanup
+     * @llm-rule WHEN: Listening to distributed events that should only fire once
+     * @llm-rule AVOID: Manual cleanup - this handles removal after first trigger
+     */
+    once(event: string, handler: EventHandler): void;
+    /**
+     * Removes event listener(s) with Redis unsubscribe management
+     * @llm-rule WHEN: Cleaning up distributed event listeners
+     * @llm-rule AVOID: Manual Redis unsubscribe - this handles cleanup automatically
+     */
+    off(event: string, handler?: EventHandler): void;
+    /**
+     * Gets current event listeners for debugging
+     * @llm-rule WHEN: Debugging distributed event listeners
+     * @llm-rule AVOID: Using for business logic - this is for debugging only
+     */
+    getListeners(event?: string): any;
+    /**
+     * Disconnects Redis strategy gracefully
+     * @llm-rule WHEN: App shutdown or event cleanup
+     * @llm-rule AVOID: Abrupt disconnection - graceful shutdown prevents connection issues
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Builds Redis channel name with prefix and namespace
+     */
+    private buildChannelName;
+    /**
+     * Serializes message data for Redis transmission
+     */
+    private serializeMessage;
+    /**
+     * Deserializes message data from Redis
+     */
+    private deserializeMessage;
+    /**
+     * Subscribes to Redis channel for specific event
+     */
+    private subscribeToEvent;
+    /**
+     * Unsubscribes from Redis channel for specific event
+     */
+    private unsubscribeFromEvent;
+    /**
+     * Handles incoming Redis messages and routes to listeners
+     */
+    private handleRedisMessage;
+    /**
+     * Gets Redis connection statistics
+     */
+    getConnectionInfo(): {
+        connected: boolean;
+        url: string;
+        namespace: string;
+        totalSubscriptions: number;
+        totalListeners: number;
+    };
+    /**
+     * Masks sensitive parts of Redis URL for logging
+     */
+    private maskUrl;
+}
+//# sourceMappingURL=redis.d.ts.map

package/dist/event/strategies/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/event/strategies/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,gBAAgB,CAAwC;IAEhE;;;;OAIG;gBACS,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;IAKlD;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsD9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2C1B;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BtD;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAqB9C;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAmBhD;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IA6BhD;;;;OAIG;IACH,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG;IAyBjC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;YACW,oBAAoB;IAiBlC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,iBAAiB,IAAI;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;KACxB;IAeD;;OAEG;IACH,OAAO,CAAC,OAAO;CAWhB"}