@bloomneo/appkit 1.2.9

package/dist/event/index.js

@@ -0,0 +1,302 @@
+/**
+ * Ultra-simple event-driven architecture that just works with automatic Redis/Memory strategy
+ * @module @bloomneo/appkit/event
+ * @file src/event/index.ts
+ *
+ * @llm-rule WHEN: Building apps that need event-driven architecture with zero configuration
+ * @llm-rule AVOID: Complex event setups - this auto-detects Redis/Memory from environment
+ * @llm-rule NOTE: Uses eventClass.get() pattern like auth - get() → event.emit() → distributed
+ * @llm-rule NOTE: Common pattern - eventClass.get(namespace) → event.on() → event.emit() → handled
+ */
+import { EventClass } from './event.js';
+import { getSmartDefaults, validateProductionRequirements, validateStartupConfiguration, performHealthCheck } from './defaults.js';
+// Global event instances for performance (like auth module)
+let globalConfig = null;
+const namedEvents = new Map();
+/**
+ * Get event instance for specific namespace - the only function you need to learn
+ * Strategy auto-detected from environment (REDIS_URL → Redis, no URL → Memory)
+ * @llm-rule WHEN: Need event-driven architecture in any part of your app - this is your main entry point
+ * @llm-rule AVOID: Creating EventClass directly - always use this function
+ * @llm-rule NOTE: Typical flow - get(namespace) → event.on() → event.emit() → distributed handling
+ */
+function get(namespace = 'default') {
+    // Validate namespace
+    if (!namespace || typeof namespace !== 'string') {
+        throw new Error('Event namespace must be a non-empty string');
+    }
+    if (!/^[a-zA-Z0-9_-]+$/.test(namespace)) {
+        throw new Error('Event namespace must contain only letters, numbers, underscores, and hyphens');
+    }
+    // Lazy initialization - parse environment once (like auth)
+    if (!globalConfig) {
+        globalConfig = getSmartDefaults();
+    }
+    // Return cached instance if exists
+    if (namedEvents.has(namespace)) {
+        return namedEvents.get(namespace);
+    }
+    // Create new event instance for namespace
+    const eventInstance = new EventClass(globalConfig, namespace);
+    // Auto-connect on first use
+    eventInstance.connect().catch((error) => {
+        console.error(`[AppKit] Event auto-connect failed for namespace "${namespace}":`, error.message);
+    });
+    namedEvents.set(namespace, eventInstance);
+    return eventInstance;
+}
+/**
+ * Clear all event instances and disconnect - essential for testing
+ * @llm-rule WHEN: Testing event logic with different configurations or app shutdown
+ * @llm-rule AVOID: Using in production except for graceful shutdown
+ */
+async function clear() {
+    const disconnectPromises = [];
+    for (const [namespace, event] of namedEvents) {
+        disconnectPromises.push(event.disconnect().catch((error) => {
+            console.error(`[AppKit] Event disconnect failed for namespace "${namespace}":`, error.message);
+        }));
+    }
+    await Promise.all(disconnectPromises);
+    namedEvents.clear();
+    globalConfig = null;
+}
+/**
+ * Reset event configuration (useful for testing)
+ * @llm-rule WHEN: Testing event logic with different environment configurations
+ * @llm-rule AVOID: Using in production - only for tests and development
+ */
+async function reset(newConfig) {
+    // Clear existing instances
+    await clear();
+    // Reset configuration
+    if (newConfig) {
+        const defaults = getSmartDefaults();
+        globalConfig = { ...defaults, ...newConfig };
+    }
+    else {
+        globalConfig = null; // Will reload from environment on next get()
+    }
+}
+/**
+ * Get active event strategy for debugging
+ * @llm-rule WHEN: Debugging or health checks to see which strategy is active (Redis vs Memory)
+ * @llm-rule AVOID: Using for application logic - events should be transparent
+ */
+function getStrategy() {
+    if (!globalConfig) {
+        globalConfig = getSmartDefaults();
+    }
+    return globalConfig.strategy;
+}
+/**
+ * Get all active event namespaces
+ * @llm-rule WHEN: Debugging or monitoring which event namespaces are active
+ * @llm-rule AVOID: Using for business logic - this is for observability only
+ */
+function getActiveNamespaces() {
+    return Array.from(namedEvents.keys());
+}
+/**
+ * Get event configuration summary for debugging
+ * @llm-rule WHEN: Health checks or debugging event configuration
+ * @llm-rule AVOID: Exposing sensitive connection details - this only shows safe info
+ */
+function getConfig() {
+    if (!globalConfig) {
+        globalConfig = getSmartDefaults();
+    }
+    return {
+        strategy: globalConfig.strategy,
+        historyEnabled: globalConfig.history.enabled,
+        activeNamespaces: getActiveNamespaces(),
+        environment: globalConfig.environment.nodeEnv,
+    };
+}
+/**
+ * Check if Redis is available and configured
+ * @llm-rule WHEN: Conditional logic based on event capabilities
+ * @llm-rule AVOID: Complex event detection - just use events normally, strategy handles it
+ */
+function hasRedis() {
+    return !!process.env.REDIS_URL;
+}
+/**
+ * Emit event across all namespaces (dangerous)
+ * @llm-rule WHEN: Broadcasting system-wide events like shutdown or maintenance
+ * @llm-rule AVOID: Using for regular events - use namespace-specific events instead
+ * @llm-rule NOTE: Only use for system-level events that need global broadcast
+ */
+async function broadcast(event, data = {}) {
+    const activeInstances = Array.from(namedEvents.values());
+    if (activeInstances.length === 0) {
+        console.warn(`[AppKit] No active event namespaces for broadcast: ${event}`);
+        return [];
+    }
+    const results = await Promise.allSettled(activeInstances.map(instance => instance.emit(event, data)));
+    return results.map(result => result.status === 'fulfilled' ? result.value : false);
+}
+/**
+ * Get event statistics across all namespaces
+ * @llm-rule WHEN: Monitoring event system health and usage
+ * @llm-rule AVOID: Using for business logic - this is for monitoring only
+ */
+function getStats() {
+    const strategy = getStrategy();
+    const namespaces = Array.from(namedEvents.entries()).map(([namespace, instance]) => {
+        const config = instance.getConfig();
+        const listeners = instance.getListeners();
+        return {
+            namespace,
+            listeners: listeners.totalListeners || 0,
+            connected: config.connected,
+        };
+    });
+    return {
+        strategy,
+        totalNamespaces: namespaces.length,
+        totalListeners: namespaces.reduce((sum, ns) => sum + ns.listeners, 0),
+        connected: namespaces.filter(ns => ns.connected).length,
+        namespaces,
+    };
+}
+/**
+ * Validate event configuration at startup with detailed feedback
+ * @llm-rule WHEN: App startup to ensure events are properly configured
+ * @llm-rule AVOID: Skipping validation - missing event config causes runtime issues
+ * @llm-rule NOTE: Returns validation results instead of throwing - allows graceful handling
+ */
+function validateConfig() {
+    try {
+        const validation = validateStartupConfiguration();
+        if (validation.errors.length > 0) {
+            console.error('[VoilaJSX AppKit] Event configuration errors:', validation.errors);
+        }
+        if (validation.warnings.length > 0) {
+            console.warn('[VoilaJSX AppKit] Event configuration warnings:', validation.warnings);
+        }
+        if (validation.ready) {
+            console.log(`✅ [VoilaJSX AppKit] Events configured with ${validation.strategy} strategy`);
+        }
+        return {
+            valid: validation.errors.length === 0,
+            strategy: validation.strategy,
+            warnings: validation.warnings,
+            errors: validation.errors,
+            ready: validation.ready,
+        };
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        console.error('[VoilaJSX AppKit] Event configuration validation failed:', errorMessage);
+        return {
+            valid: false,
+            strategy: 'unknown',
+            warnings: [],
+            errors: [errorMessage],
+            ready: false,
+        };
+    }
+}
+/**
+ * Validate production requirements and throw if critical issues found
+ * @llm-rule WHEN: Production deployment validation - ensures events work in production
+ * @llm-rule AVOID: Skipping in production - event failures are often silent
+ * @llm-rule NOTE: Throws on critical issues, warns on non-critical ones
+ */
+function validateProduction() {
+    try {
+        validateProductionRequirements();
+        if (process.env.NODE_ENV === 'production' && !hasRedis()) {
+            console.warn('[VoilaJSX AppKit] No Redis configured in production. ' +
+                'Set REDIS_URL for distributed events across servers.');
+        }
+        console.log('✅ [VoilaJSX AppKit] Production event requirements validated');
+    }
+    catch (error) {
+        console.error('[VoilaJSX AppKit] Production event validation failed:', error.message);
+        throw error;
+    }
+}
+/**
+ * Get comprehensive health check status for monitoring
+ * @llm-rule WHEN: Health check endpoints or monitoring systems
+ * @llm-rule AVOID: Using in critical application path - this is for monitoring only
+ * @llm-rule NOTE: Returns detailed status without exposing sensitive configuration
+ */
+function getHealthStatus() {
+    return performHealthCheck();
+}
+/**
+ * Graceful shutdown for all event instances
+ * @llm-rule WHEN: App shutdown or process termination
+ * @llm-rule AVOID: Abrupt process exit - graceful shutdown prevents data loss
+ */
+async function shutdown() {
+    console.log('🔄 [AppKit] Event graceful shutdown...');
+    try {
+        // Broadcast shutdown event before closing
+        await broadcast('system.shutdown', {
+            timestamp: new Date().toISOString(),
+            reason: 'graceful_shutdown'
+        });
+        // Small delay to allow event processing
+        await new Promise(resolve => setTimeout(resolve, 100));
+        // Clear all instances
+        await clear();
+        console.log('✅ [AppKit] Event shutdown complete');
+    }
+    catch (error) {
+        console.error('❌ [AppKit] Event shutdown error:', error.message);
+    }
+}
+/**
+ * Single eventing export with minimal API (like auth module)
+ */
+export const eventClass = {
+    // Core method (like auth.get())
+    get,
+    // Utility methods
+    clear,
+    reset,
+    getStrategy,
+    getActiveNamespaces,
+    getConfig,
+    hasRedis,
+    getStats,
+    // Advanced methods
+    broadcast,
+    // Validation and lifecycle
+    validateConfig,
+    validateProduction,
+    getHealthStatus,
+    shutdown,
+};
+export { EventClass } from './event.js';
+// Default export
+export default eventClass;
+// Auto-setup graceful shutdown handlers
+if (typeof process !== 'undefined') {
+    // Handle graceful shutdown
+    const shutdownHandler = () => {
+        shutdown().finally(() => {
+            process.exit(0);
+        });
+    };
+    process.on('SIGTERM', shutdownHandler);
+    process.on('SIGINT', shutdownHandler);
+    // Handle uncaught errors
+    process.on('uncaughtException', (error) => {
+        console.error('[AppKit] Uncaught exception during event operation:', error);
+        shutdown().finally(() => {
+            process.exit(1);
+        });
+    });
+    process.on('unhandledRejection', (reason) => {
+        console.error('[AppKit] Unhandled rejection during event operation:', reason);
+        shutdown().finally(() => {
+            process.exit(1);
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/event/index.js.map

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

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

@@ -0,0 +1,122 @@
+/**
+ * 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 type { EventStrategy, EventHandler } from '../event.js';
+import type { EventConfig } from '../defaults.js';
+/**
+ * Memory event strategy with intelligent cleanup and limits
+ */
+export declare class MemoryStrategy implements EventStrategy {
+    private config;
+    private namespace;
+    private emitter;
+    private cleanupInterval;
+    private listenerCounts;
+    /**
+     * 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: EventConfig, namespace: string);
+    /**
+     * 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
+     */
+    emit(event: string, data: any): Promise<boolean>;
+    /**
+     * 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: string, handler: EventHandler): void;
+    /**
+     * 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: string, handler: EventHandler): void;
+    /**
+     * 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: string, handler?: EventHandler): void;
+    /**
+     * 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?: string): any;
+    /**
+     * Disconnects memory strategy gracefully
+     * @llm-rule WHEN: App shutdown or event cleanup
+     * @llm-rule AVOID: Memory leaks - always cleanup intervals and listeners
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Checks if adding listener would exceed limit
+     */
+    private checkListenerLimit;
+    /**
+     * Increments listener count tracking
+     */
+    private incrementListenerCount;
+    /**
+     * Decrements listener count tracking
+     */
+    private decrementListenerCount;
+    /**
+     * Updates listener count from actual emitter state
+     */
+    private updateListenerCount;
+    /**
+     * Sets up automatic cleanup interval
+     */
+    private setupCleanup;
+    /**
+     * Stops cleanup interval
+     */
+    private stopCleanup;
+    /**
+     * Performs memory cleanup and garbage collection
+     */
+    private performCleanup;
+    /**
+     * Syncs tracking counts with actual emitter state
+     */
+    private syncListenerCounts;
+    /**
+     * Cleans up events with no listeners
+     */
+    private cleanupEmptyEvents;
+    /**
+     * Gets memory usage statistics
+     */
+    private getMemoryStats;
+    /**
+     * Gets detailed memory statistics for debugging
+     */
+    getDetailedStats(): {
+        strategy: string;
+        namespace: string;
+        totalEvents: number;
+        totalListeners: number;
+        maxListeners: number;
+        memoryUsage: string;
+        events: Array<{
+            event: string;
+            listeners: number;
+        }>;
+        cleanupEnabled: boolean;
+        lastCleanup: string;
+    };
+}
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/event/strategies/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,cAAc,CAA6B;IAEnD;;;;OAIG;gBACS,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM;IAkBlD;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAetD;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAmB9C;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAyBhD;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAqBhD;;;;OAIG;IACH,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG;IAwBjC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBjC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,gBAAgB,IAAI;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,cAAc,EAAE,OAAO,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;KACrB;CAsBF"}