@orchestr-sh/orchestr 1.6.0 → 1.7.0

package/dist/Events/EventDiscoveryCache.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventDiscoveryCache = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * EventDiscoveryCache
+ *
+ * Manages caching of discovered event-listener mappings to improve performance.
+ * Cache is stored as JSON in the storage/framework directory.
+ *
+ * This prevents the need to scan and parse TypeScript files on every application
+ * boot in production environments.
+ *
+ * @example
+ * ```typescript
+ * const cache = new EventDiscoveryCache(app)
+ *
+ * // Check if cache exists
+ * if (cache.exists()) {
+ *   const listeners = cache.load()
+ * }
+ *
+ * // Store discovered listeners
+ * cache.store(discoveredListeners)
+ *
+ * // Clear cache
+ * cache.clear()
+ * ```
+ */
+class EventDiscoveryCache {
+    app;
+    /**
+     * Current cache format version
+     */
+    static CACHE_VERSION = '1.0';
+    /**
+     * Default cache file path relative to storage directory
+     */
+    static CACHE_PATH = 'framework/events.json';
+    constructor(app) {
+        this.app = app;
+    }
+    /**
+     * Get the full path to the cache file
+     *
+     * @returns Absolute path to the events cache file
+     */
+    getCachePath() {
+        return this.app.storagePath(EventDiscoveryCache.CACHE_PATH);
+    }
+    /**
+     * Determine if the events cache file exists
+     *
+     * @returns True if cache file exists and is readable
+     *
+     * @example
+     * ```typescript
+     * if (cache.exists()) {
+     *   // Use cached events
+     * } else {
+     *   // Discover events
+     * }
+     * ```
+     */
+    exists() {
+        try {
+            return (0, fs_1.existsSync)(this.getCachePath());
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load cached event-listener mappings
+     *
+     * Reads the cache file and returns a Map of event names to listener paths.
+     * If the cache file doesn't exist or is invalid, returns an empty Map.
+     *
+     * @returns Map of event names to array of listener class paths
+     *
+     * @example
+     * ```typescript
+     * const listeners = cache.load()
+     * // Returns: Map {
+     * //   'UserRegistered' => ['Listeners/SendWelcomeEmail', 'Listeners/CreateUserProfile'],
+     * //   'OrderPlaced' => ['Listeners/SendOrderConfirmation']
+     * // }
+     * ```
+     */
+    load() {
+        if (!this.exists()) {
+            return new Map();
+        }
+        try {
+            const cachePath = this.getCachePath();
+            const contents = (0, fs_1.readFileSync)(cachePath, 'utf-8');
+            const data = JSON.parse(contents);
+            // Validate cache version
+            if (data.version !== EventDiscoveryCache.CACHE_VERSION) {
+                if (this.app.isDebug()) {
+                    console.warn(`Event cache version mismatch. Expected ${EventDiscoveryCache.CACHE_VERSION}, got ${data.version}`);
+                }
+                return new Map();
+            }
+            // Convert cache format to Map
+            const listeners = new Map();
+            for (const [eventName, entry] of Object.entries(data.events)) {
+                listeners.set(eventName, entry.listeners);
+            }
+            return listeners;
+        }
+        catch (error) {
+            if (this.app.isDebug()) {
+                console.warn('Failed to load event cache:', error);
+            }
+            return new Map();
+        }
+    }
+    /**
+     * Store event-listener mappings in cache
+     *
+     * Writes the discovered listeners to the cache file in JSON format.
+     * Creates the cache directory if it doesn't exist.
+     *
+     * @param listeners Map of event names to listener class paths
+     * @returns True if cache was successfully written, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const discovery = new EventDiscovery(app)
+     * const listeners = await discovery.discover([app.path('Listeners')])
+     * cache.store(listeners)
+     * ```
+     */
+    store(listeners) {
+        try {
+            const cachePath = this.getCachePath();
+            const cacheDir = (0, path_1.dirname)(cachePath);
+            // Create cache directory if it doesn't exist
+            if (!(0, fs_1.existsSync)(cacheDir)) {
+                (0, fs_1.mkdirSync)(cacheDir, { recursive: true });
+            }
+            // Build cache structure
+            const cache = {
+                version: EventDiscoveryCache.CACHE_VERSION,
+                generatedAt: Date.now(),
+                events: {}
+            };
+            const now = Date.now();
+            for (const [eventName, listenerList] of listeners) {
+                cache.events[eventName] = {
+                    event: eventName,
+                    listeners: listenerList,
+                    cachedAt: now
+                };
+            }
+            // Write cache file with pretty formatting for readability
+            (0, fs_1.writeFileSync)(cachePath, JSON.stringify(cache, null, 2), 'utf-8');
+            return true;
+        }
+        catch (error) {
+            if (this.app.isDebug()) {
+                console.error('Failed to write event cache:', error);
+            }
+            return false;
+        }
+    }
+    /**
+     * Clear the events cache
+     *
+     * Deletes the cache file. This is typically called by the event:clear command
+     * or when the cache needs to be invalidated.
+     *
+     * @returns True if cache was successfully cleared or didn't exist, false on error
+     *
+     * @example
+     * ```typescript
+     * cache.clear()
+     * // Cache file deleted, discovery will run on next boot
+     * ```
+     */
+    clear() {
+        try {
+            const cachePath = this.getCachePath();
+            if (!(0, fs_1.existsSync)(cachePath)) {
+                return true; // Already cleared
+            }
+            const fs = require('fs');
+            fs.unlinkSync(cachePath);
+            return true;
+        }
+        catch (error) {
+            if (this.app.isDebug()) {
+                console.error('Failed to clear event cache:', error);
+            }
+            return false;
+        }
+    }
+    /**
+     * Get cache metadata
+     *
+     * Returns information about the cache without loading all entries.
+     * Useful for displaying cache status.
+     *
+     * @returns Cache metadata or null if cache doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const metadata = cache.getMetadata()
+     * console.log(`Cache generated at: ${new Date(metadata.generatedAt)}`)
+     * console.log(`Total events: ${Object.keys(metadata.events).length}`)
+     * ```
+     */
+    getMetadata() {
+        if (!this.exists()) {
+            return null;
+        }
+        try {
+            const cachePath = this.getCachePath();
+            const contents = (0, fs_1.readFileSync)(cachePath, 'utf-8');
+            const data = JSON.parse(contents);
+            return {
+                version: data.version,
+                generatedAt: data.generatedAt,
+                eventCount: Object.keys(data.events).length
+            };
+        }
+        catch (error) {
+            if (this.app.isDebug()) {
+                console.warn('Failed to read event cache metadata:', error);
+            }
+            return null;
+        }
+    }
+    /**
+     * Check if cache is stale based on a timestamp
+     *
+     * Useful for invalidating cache based on file modification times
+     * or other external factors.
+     *
+     * @param threshold Timestamp in milliseconds. Cache is stale if older than this.
+     * @returns True if cache exists and is older than threshold
+     *
+     * @example
+     * ```typescript
+     * // Check if cache is older than 1 hour
+     * const oneHourAgo = Date.now() - (60 * 60 * 1000)
+     * if (cache.isStale(oneHourAgo)) {
+     *   cache.clear()
+     *   // Re-discover events
+     * }
+     * ```
+     */
+    isStale(threshold) {
+        const metadata = this.getMetadata();
+        if (!metadata) {
+            return true; // No cache = stale
+        }
+        return metadata.generatedAt < threshold;
+    }
+    /**
+     * Get statistics about the cache
+     *
+     * Returns detailed statistics about cached events and listeners.
+     *
+     * @returns Cache statistics or null if cache doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const stats = cache.getStatistics()
+     * console.log(`Total events: ${stats.totalEvents}`)
+     * console.log(`Total listeners: ${stats.totalListeners}`)
+     * ```
+     */
+    getStatistics() {
+        if (!this.exists()) {
+            return null;
+        }
+        try {
+            const cachePath = this.getCachePath();
+            const contents = (0, fs_1.readFileSync)(cachePath, 'utf-8');
+            const data = JSON.parse(contents);
+            let totalListeners = 0;
+            let largestEvent = null;
+            for (const [eventName, entry] of Object.entries(data.events)) {
+                const listenerCount = entry.listeners.length;
+                totalListeners += listenerCount;
+                if (!largestEvent || listenerCount > largestEvent.listenerCount) {
+                    largestEvent = { name: eventName, listenerCount };
+                }
+            }
+            const totalEvents = Object.keys(data.events).length;
+            return {
+                totalEvents,
+                totalListeners,
+                averageListenersPerEvent: totalEvents > 0 ? totalListeners / totalEvents : 0,
+                largestEvent
+            };
+        }
+        catch (error) {
+            if (this.app.isDebug()) {
+                console.warn('Failed to calculate cache statistics:', error);
+            }
+            return null;
+        }
+    }
+}
+exports.EventDiscoveryCache = EventDiscoveryCache;
+//# sourceMappingURL=EventDiscoveryCache.js.map

package/dist/Events/EventDiscoveryCache.js.map

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

package/dist/Events/EventServiceProvider.d.ts

@@ -0,0 +1,148 @@
+import { ServiceProvider } from '../Foundation/ServiceProvider';
+import { Dispatcher } from './Dispatcher';
+/**
+ * Event Service Provider
+ *
+ * Provides event registration and discovery services following Laravel's
+ * EventServiceProvider pattern. Supports both manual registration and
+ * automatic listener discovery.
+ *
+ * @example
+ * ```typescript
+ * export class AppEventServiceProvider extends EventServiceProvider {
+ *   protected listen = {
+ *     'UserRegistered': [
+ *       'SendWelcomeEmail',
+ *       'CreateUserProfile'
+ *     ],
+ *     'OrderPlaced': 'SendOrderConfirmation'
+ *   }
+ *
+ *   protected subscribe = [
+ *     'UserEventSubscriber'
+ *   ]
+ * }
+ * ```
+ */
+export declare abstract class EventServiceProvider extends ServiceProvider {
+    /**
+     * The event listener mappings for the application
+     *
+     * Maps event names to listener class names (string) or arrays of listener names.
+     *
+     * @example
+     * ```typescript
+     * protected listen = {
+     *   'UserRegistered': ['SendWelcomeEmail', 'LogRegistration'],
+     *   'OrderPlaced': 'ProcessOrder'
+     * }
+     * ```
+     */
+    protected listen: Record<string, string | string[]>;
+    /**
+     * The subscriber classes to register
+     *
+     * Subscribers provide their own event-to-listener mappings via a subscribe() method.
+     *
+     * @example
+     * ```typescript
+     * protected subscribe = [
+     *   'UserEventSubscriber',
+     *   'OrderEventSubscriber'
+     * ]
+     * ```
+     */
+    protected subscribe: string[];
+    /**
+     * Register the application's event listeners
+     *
+     * Binds the event dispatcher as a singleton in the container.
+     */
+    register(): void;
+    /**
+     * Bootstrap the application events
+     *
+     * Performs three key operations:
+     * 1. Registers manual event-listener mappings from the `listen` property
+     * 2. Registers event subscribers from the `subscribe` property
+     * 3. Performs automatic event discovery if enabled
+     *
+     * @throws {Error} If the dispatcher cannot be resolved from the container
+     */
+    boot(): Promise<void>;
+    /**
+     * Determine if events and listeners should be automatically discovered
+     *
+     * By default, discovery is enabled unless events are cached.
+     * Override this method to customize discovery behavior.
+     *
+     * @returns {boolean} True if event discovery should run
+     *
+     * @example
+     * ```typescript
+     * protected shouldDiscoverEvents(): boolean {
+     *   // Disable discovery in production
+     *   return this.app.environment() !== 'production'
+     * }
+     * ```
+     */
+    protected shouldDiscoverEvents(): boolean;
+    /**
+     * Discover the events and listeners for the application
+     *
+     * Uses EventDiscovery to scan specified directories for listener classes
+     * and automatically registers them with their corresponding events.
+     *
+     * @param {Dispatcher} events - The event dispatcher instance
+     *
+     * @throws {Error} If EventDiscovery is not available (Task 6 dependency)
+     */
+    protected discoverEvents(events: Dispatcher): Promise<void>;
+    /**
+     * Get the directories to discover events within
+     *
+     * By default, uses the paths configured via Application.withEvents()
+     * or falls back to the standard 'Listeners' directory.
+     *
+     * Override this method to customize discovery paths.
+     *
+     * @returns {string[]} Array of absolute directory paths to scan
+     *
+     * @example
+     * ```typescript
+     * protected discoverEventsWithin(): string[] {
+     *   return [
+     *     this.app.path('Listeners'),
+     *     this.app.path('Domain/Listeners')
+     *   ]
+     * }
+     * ```
+     */
+    protected discoverEventsWithin(): string[];
+    /**
+     * Determine if events are cached
+     *
+     * Checks for the existence of the cached events file.
+     *
+     * @returns {boolean} True if cached events file exists
+     */
+    protected eventsAreCached(): boolean;
+    /**
+     * Get the events and handlers from the cached file
+     *
+     * Loads and parses the cached events JSON file.
+     *
+     * @returns {Map<string, string[]>} Map of event names to listener class names
+     */
+    protected getCachedEvents(): Map<string, string[]>;
+    /**
+     * Get all registered event-listener mappings
+     *
+     * Returns the complete mapping of events to listeners for inspection.
+     * Useful for debugging and console commands.
+     *
+     * @returns {Record<string, string | string[]>} The listen property mappings
+     */
+    listens(): Record<string, string | string[]>;
+}
+//# sourceMappingURL=EventServiceProvider.d.ts.map

package/dist/Events/EventServiceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventServiceProvider.d.ts","sourceRoot":"","sources":["../../src/Events/EventServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,oBAAqB,SAAQ,eAAe;IAChE;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAM;IAEzD;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,CAAM;IAEnC;;;;OAIG;IACH,QAAQ,IAAI,IAAI;IAShB;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,oBAAoB,IAAI,OAAO;IAKzC;;;;;;;;;OASG;cACa,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,oBAAoB,IAAI,MAAM,EAAE;IAI1C;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,IAAI,OAAO;IAUpC;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAgBlD;;;;;;;OAOG;IACH,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAG7C"}