@orchestr-sh/orchestr 1.10.0 → 1.11.0

package/dist/Events/Decorators/HandlesEvents.js

@@ -1,105 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HandlesEvents = HandlesEvents;
-exports.hasHandlesEventsMetadata = hasHandlesEventsMetadata;
-exports.getHandledEvents = getHandledEvents;
-require("reflect-metadata");
-/**
- * HandlesEvents Decorator
- *
- * Decorator to explicitly specify which events a listener handles.
- * This is particularly useful for:
- * - Union types (TypeScript can't reflect union type information at runtime)
- * - Multiple events handled by a single listener
- * - Clarifying listener behavior
- *
- * The decorator stores the event types in metadata that can be read by
- * the EventDiscovery system during listener scanning.
- *
- * @param events Array of event class constructors this listener handles
- * @returns Class decorator function
- *
- * @example
- * ```typescript
- * import { HandlesEvents } from '@orchestr/Events/Decorators/HandlesEvents'
- * import { UserRegistered } from '../Events/UserRegistered'
- * import { UserUpdated } from '../Events/UserUpdated'
- *
- * // Single event
- * @HandlesEvents([UserRegistered])
- * class SendWelcomeEmail {
- *   handle(event: UserRegistered) {
- *     // Send welcome email
- *   }
- * }
- *
- * // Multiple events (union type)
- * @HandlesEvents([UserRegistered, UserUpdated])
- * class UserNotificationListener {
- *   handle(event: UserRegistered | UserUpdated) {
- *     if (event instanceof UserRegistered) {
- *       // Handle registration
- *     } else {
- *       // Handle update
- *     }
- *   }
- * }
- *
- * // With ShouldQueue
- * @HandlesEvents([OrderPlaced])
- * class ProcessOrderListener implements ShouldQueue {
- *   public queue = 'orders'
- *
- *   async handle(event: OrderPlaced) {
- *     // Process order
- *   }
- * }
- * ```
- */
-function HandlesEvents(events) {
-    return function (target) {
-        // Store event types in metadata
-        // This metadata is read by EventDiscovery.extractEventTypes()
-        Reflect.defineMetadata('event:types', events, target);
-        return target;
-    };
-}
-/**
- * Type guard to check if a class has the HandlesEvents decorator
- *
- * @param target Class to check
- * @returns True if class has HandlesEvents metadata
- *
- * @example
- * ```typescript
- * if (hasHandlesEventsMetadata(MyListener)) {
- *   const events = getHandledEvents(MyListener)
- *   console.log('Listener handles:', events)
- * }
- * ```
- */
-function hasHandlesEventsMetadata(target) {
-    if (typeof target !== 'function')
-        return false;
-    const metadata = Reflect.getMetadata('event:types', target);
-    return metadata !== undefined && Array.isArray(metadata);
-}
-/**
- * Get the event types from a listener class decorated with @HandlesEvents
- *
- * @param target Listener class constructor
- * @returns Array of event class constructors, or empty array if not decorated
- *
- * @example
- * ```typescript
- * const events = getHandledEvents(SendWelcomeEmail)
- * // Returns: [UserRegistered]
- * ```
- */
-function getHandledEvents(target) {
-    if (!hasHandlesEventsMetadata(target)) {
-        return [];
-    }
-    return Reflect.getMetadata('event:types', target) || [];
-}
-//# sourceMappingURL=HandlesEvents.js.map

package/dist/Events/Decorators/HandlesEvents.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"HandlesEvents.js","sourceRoot":"","sources":["../../../src/Events/Decorators/HandlesEvents.ts"],"names":[],"mappings":";;AAsDA,sCAQC;AAgBD,4DAKC;AAcD,4CAMC;AAvGD,4BAA0B;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,SAAgB,aAAa,CAAC,MAAuC;IACnE,OAAO,UAAU,MAAW;QAC1B,gCAAgC;QAChC,8DAA8D;QAC9D,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAEtD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,wBAAwB,CAAC,MAAW;IAClD,IAAI,OAAO,MAAM,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAE/C,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5D,OAAO,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,gBAAgB,CAAC,MAAW;IAC1C,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC"}

package/dist/Events/Dispatcher.d.ts

@@ -1,201 +0,0 @@
-import type { Container } from '../Container/Container';
-import type { DispatcherContract } from './Contracts/Dispatcher';
-import type { Event } from './Event';
-import type { EventListener, EventSubscriber } from './types';
-/**
- * Event Dispatcher
- *
- * The core event dispatcher implementation. Manages event listeners,
- * handles wildcard patterns, and dispatches events to registered listeners.
- *
- * @example
- * ```typescript
- * const dispatcher = new Dispatcher(container);
- *
- * // Register listeners
- * dispatcher.listen('user.registered', SendWelcomeEmail);
- * dispatcher.listen('user.*', LogUserActivity);
- *
- * // Dispatch events
- * dispatcher.dispatch(new UserRegistered(user));
- * ```
- */
-export declare class Dispatcher implements DispatcherContract {
-    protected container: Container;
-    /**
-     * Registered event listeners (direct event name matches)
-     */
-    protected listeners: Map<string, EventListener[]>;
-    /**
-     * Wildcard event listeners (patterns like 'user.*')
-     */
-    protected wildcards: Map<string, EventListener[]>;
-    /**
-     * Queued events waiting to be flushed
-     */
-    protected queuedEvents: Map<string, Array<{
-        payload: any[];
-    }>>;
-    /**
-     * Create a new event dispatcher
-     *
-     * @param container - The service container for resolving listeners
-     */
-    constructor(container: Container);
-    /**
-     * Register an event listener
-     *
-     * Supports single events, multiple events, and wildcard patterns
-     *
-     * @param events - Event name(s) to listen for
-     * @param listener - Listener to invoke when event is dispatched
-     */
-    listen(events: string | string[], listener: EventListener): void;
-    /**
-     * Check if an event has any listeners
-     *
-     * Checks both direct listeners and wildcard matches
-     *
-     * @param eventName - The event name to check
-     * @returns True if the event has listeners
-     */
-    hasListeners(eventName: string): boolean;
-    /**
-     * Register an event subscriber
-     *
-     * Subscribers can register multiple event listeners at once
-     *
-     * @param subscriber - The subscriber instance
-     */
-    subscribe(subscriber: EventSubscriber): void;
-    /**
-     * Dispatch an event to all listeners
-     *
-     * @param event - Event name or instance
-     * @param payload - Additional arguments to pass to listeners
-     * @param halt - Stop dispatching if a listener returns false
-     * @returns Array of results from listeners
-     */
-    dispatch(event: string | Event, payload?: any[], halt?: boolean): any[];
-    /**
-     * Dispatch an event until a listener returns a non-null response
-     *
-     * @param event - Event name or instance
-     * @param payload - Additional arguments to pass to listeners
-     * @returns The first non-null response from a listener
-     */
-    until(event: string | Event, payload?: any[]): any;
-    /**
-     * Queue an event for later dispatch
-     *
-     * @param event - Event name
-     * @param payload - Event payload
-     */
-    push(event: string, payload?: any[]): void;
-    /**
-     * Flush (dispatch) all queued events for a specific event name
-     *
-     * @param event - Event name to flush
-     */
-    flush(event: string): void;
-    /**
-     * Remove all listeners for an event
-     *
-     * @param event - Event name
-     */
-    forget(event: string): void;
-    /**
-     * Clear all queued events
-     */
-    forgetPushed(): void;
-    /**
-     * Get raw listener mappings
-     *
-     * @returns Map of event names to their listeners
-     */
-    getRawListeners(): Map<string, EventListener[]>;
-    /**
-     * Get all listeners for an event (direct + wildcard matches)
-     *
-     * @param eventName - The event name
-     * @returns Array of listeners
-     */
-    protected getListeners(eventName: string): EventListener[];
-    /**
-     * Setup a wildcard listener
-     *
-     * @param event - Wildcard pattern (e.g., 'user.*')
-     * @param listener - Listener to invoke
-     */
-    protected setupWildcardListen(event: string, listener: EventListener): void;
-    /**
-     * Get all wildcard listeners matching an event name
-     *
-     * @param eventName - The event name to match
-     * @returns Array of matching listeners
-     */
-    protected getWildcardListeners(eventName: string): EventListener[];
-    /**
-     * Check if an event name matches a wildcard pattern
-     *
-     * Supports patterns like:
-     * - 'event.*' - Matches 'event.created', 'event.updated', etc.
-     * - 'event.*.action' - Matches 'event.user.action', 'event.post.action', etc.
-     * - '*' - Matches everything
-     *
-     * @param pattern - Wildcard pattern
-     * @param eventName - Event name to test
-     * @returns True if the pattern matches
-     */
-    protected wildcardMatch(pattern: string, eventName: string): boolean;
-    /**
-     * Parse event and payload from dispatch arguments
-     *
-     * @param event - Event name or instance
-     * @param payload - Event payload
-     * @returns Tuple of [eventName, eventInstance]
-     */
-    protected parseEventAndPayload(event: string | Event, payload: any[]): [string, Event | null];
-    /**
-     * Call a listener with the event and payload
-     *
-     * Handles different listener types (closure, class instance, string reference)
-     *
-     * @param listener - The listener to call
-     * @param event - Event name or instance
-     * @param payload - Additional payload arguments
-     * @returns The result from the listener
-     */
-    protected callListener(listener: EventListener, event: string | Event, payload: any[]): any;
-    /**
-     * Create a callable function from a listener
-     *
-     * Resolves string listeners from container and wraps class instances
-     *
-     * @param listener - The listener to convert
-     * @param wildcard - Whether this is for a wildcard listener
-     * @returns Callable function
-     */
-    protected makeListener(listener: EventListener, wildcard?: boolean): (...args: any[]) => any;
-    /**
-     * Create a listener from a class string reference
-     *
-     * Resolves the class from the container and calls its handle method
-     *
-     * @param listener - Class name/path to resolve
-     * @param wildcard - Whether this is for a wildcard listener
-     * @returns Callable function
-     */
-    protected createClassListener(listener: string, wildcard?: boolean): (...args: any[]) => any;
-    /**
-     * Check if an event should broadcast
-     *
-     * This is a placeholder for future broadcasting support
-     *
-     * @param event - The event instance
-     * @param payload - The event payload
-     * @returns True if should broadcast
-     */
-    protected shouldBroadcast(event: Event, payload: any[]): boolean;
-}
-//# sourceMappingURL=Dispatcher.d.ts.map

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

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

package/dist/Events/Dispatcher.js

@@ -1,366 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Dispatcher = void 0;
-/**
- * Event Dispatcher
- *
- * The core event dispatcher implementation. Manages event listeners,
- * handles wildcard patterns, and dispatches events to registered listeners.
- *
- * @example
- * ```typescript
- * const dispatcher = new Dispatcher(container);
- *
- * // Register listeners
- * dispatcher.listen('user.registered', SendWelcomeEmail);
- * dispatcher.listen('user.*', LogUserActivity);
- *
- * // Dispatch events
- * dispatcher.dispatch(new UserRegistered(user));
- * ```
- */
-class Dispatcher {
-    container;
-    /**
-     * Registered event listeners (direct event name matches)
-     */
-    listeners = new Map();
-    /**
-     * Wildcard event listeners (patterns like 'user.*')
-     */
-    wildcards = new Map();
-    /**
-     * Queued events waiting to be flushed
-     */
-    queuedEvents = new Map();
-    /**
-     * Create a new event dispatcher
-     *
-     * @param container - The service container for resolving listeners
-     */
-    constructor(container) {
-        this.container = container;
-    }
-    /**
-     * Register an event listener
-     *
-     * Supports single events, multiple events, and wildcard patterns
-     *
-     * @param events - Event name(s) to listen for
-     * @param listener - Listener to invoke when event is dispatched
-     */
-    listen(events, listener) {
-        const eventArray = Array.isArray(events) ? events : [events];
-        for (const event of eventArray) {
-            if (event.includes('*')) {
-                this.setupWildcardListen(event, listener);
-            }
-            else {
-                if (!this.listeners.has(event)) {
-                    this.listeners.set(event, []);
-                }
-                this.listeners.get(event).push(listener);
-            }
-        }
-    }
-    /**
-     * Check if an event has any listeners
-     *
-     * Checks both direct listeners and wildcard matches
-     *
-     * @param eventName - The event name to check
-     * @returns True if the event has listeners
-     */
-    hasListeners(eventName) {
-        return this.getListeners(eventName).length > 0;
-    }
-    /**
-     * Register an event subscriber
-     *
-     * Subscribers can register multiple event listeners at once
-     *
-     * @param subscriber - The subscriber instance
-     */
-    subscribe(subscriber) {
-        const result = subscriber.subscribe(this);
-        // If the subscriber returns a mapping, register those listeners
-        if (result && typeof result === 'object') {
-            for (const [event, listeners] of Object.entries(result)) {
-                const listenerArray = Array.isArray(listeners) ? listeners : [listeners];
-                for (const listener of listenerArray) {
-                    this.listen(event, listener);
-                }
-            }
-        }
-    }
-    /**
-     * Dispatch an event to all listeners
-     *
-     * @param event - Event name or instance
-     * @param payload - Additional arguments to pass to listeners
-     * @param halt - Stop dispatching if a listener returns false
-     * @returns Array of results from listeners
-     */
-    dispatch(event, payload = [], halt = false) {
-        const [eventName, eventInstance] = this.parseEventAndPayload(event, payload);
-        // Check if we should broadcast this event (for future broadcasting support)
-        if (eventInstance) {
-            this.shouldBroadcast(eventInstance, payload);
-        }
-        const listeners = this.getListeners(eventName);
-        const responses = [];
-        for (const listener of listeners) {
-            const response = this.callListener(listener, eventInstance || eventName, payload);
-            // If halting and response is false, stop propagation
-            if (halt && response === false) {
-                return responses;
-            }
-            // Collect non-null responses
-            if (response !== null && response !== undefined) {
-                responses.push(response);
-            }
-        }
-        return responses;
-    }
-    /**
-     * Dispatch an event until a listener returns a non-null response
-     *
-     * @param event - Event name or instance
-     * @param payload - Additional arguments to pass to listeners
-     * @returns The first non-null response from a listener
-     */
-    until(event, payload = []) {
-        const [eventName, eventInstance] = this.parseEventAndPayload(event, payload);
-        const listeners = this.getListeners(eventName);
-        for (const listener of listeners) {
-            const response = this.callListener(listener, eventInstance || eventName, payload);
-            if (response !== null && response !== undefined) {
-                return response;
-            }
-        }
-        return null;
-    }
-    /**
-     * Queue an event for later dispatch
-     *
-     * @param event - Event name
-     * @param payload - Event payload
-     */
-    push(event, payload = []) {
-        if (!this.queuedEvents.has(event)) {
-            this.queuedEvents.set(event, []);
-        }
-        this.queuedEvents.get(event).push({ payload });
-    }
-    /**
-     * Flush (dispatch) all queued events for a specific event name
-     *
-     * @param event - Event name to flush
-     */
-    flush(event) {
-        const queued = this.queuedEvents.get(event);
-        if (!queued || queued.length === 0) {
-            return;
-        }
-        // Dispatch each queued event
-        for (const { payload } of queued) {
-            this.dispatch(event, payload);
-        }
-        // Clear the queue for this event
-        this.queuedEvents.delete(event);
-    }
-    /**
-     * Remove all listeners for an event
-     *
-     * @param event - Event name
-     */
-    forget(event) {
-        this.listeners.delete(event);
-        this.wildcards.delete(event);
-    }
-    /**
-     * Clear all queued events
-     */
-    forgetPushed() {
-        this.queuedEvents.clear();
-    }
-    /**
-     * Get raw listener mappings
-     *
-     * @returns Map of event names to their listeners
-     */
-    getRawListeners() {
-        return this.listeners;
-    }
-    /**
-     * Get all listeners for an event (direct + wildcard matches)
-     *
-     * @param eventName - The event name
-     * @returns Array of listeners
-     */
-    getListeners(eventName) {
-        const directListeners = this.listeners.get(eventName) || [];
-        const wildcardListeners = this.getWildcardListeners(eventName);
-        return [...directListeners, ...wildcardListeners];
-    }
-    /**
-     * Setup a wildcard listener
-     *
-     * @param event - Wildcard pattern (e.g., 'user.*')
-     * @param listener - Listener to invoke
-     */
-    setupWildcardListen(event, listener) {
-        if (!this.wildcards.has(event)) {
-            this.wildcards.set(event, []);
-        }
-        this.wildcards.get(event).push(listener);
-    }
-    /**
-     * Get all wildcard listeners matching an event name
-     *
-     * @param eventName - The event name to match
-     * @returns Array of matching listeners
-     */
-    getWildcardListeners(eventName) {
-        const matched = [];
-        for (const [pattern, listeners] of this.wildcards) {
-            if (this.wildcardMatch(pattern, eventName)) {
-                matched.push(...listeners);
-            }
-        }
-        return matched;
-    }
-    /**
-     * Check if an event name matches a wildcard pattern
-     *
-     * Supports patterns like:
-     * - 'event.*' - Matches 'event.created', 'event.updated', etc.
-     * - 'event.*.action' - Matches 'event.user.action', 'event.post.action', etc.
-     * - '*' - Matches everything
-     *
-     * @param pattern - Wildcard pattern
-     * @param eventName - Event name to test
-     * @returns True if the pattern matches
-     */
-    wildcardMatch(pattern, eventName) {
-        // Convert wildcard pattern to regex
-        // Escape special regex characters except *
-        const regexPattern = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
-        const regex = new RegExp(`^${regexPattern}$`);
-        return regex.test(eventName);
-    }
-    /**
-     * Parse event and payload from dispatch arguments
-     *
-     * @param event - Event name or instance
-     * @param payload - Event payload
-     * @returns Tuple of [eventName, eventInstance]
-     */
-    parseEventAndPayload(event, payload) {
-        if (typeof event === 'string') {
-            return [event, null];
-        }
-        // Event is an object
-        return [event.constructor.name, event];
-    }
-    /**
-     * Call a listener with the event and payload
-     *
-     * Handles different listener types (closure, class instance, string reference)
-     *
-     * @param listener - The listener to call
-     * @param event - Event name or instance
-     * @param payload - Additional payload arguments
-     * @returns The result from the listener
-     */
-    callListener(listener, event, payload) {
-        try {
-            const callable = this.makeListener(listener);
-            return callable(event, ...payload);
-        }
-        catch (error) {
-            // Re-throw the error to allow application-level error handling
-            console.error(`Error calling event listener:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Create a callable function from a listener
-     *
-     * Resolves string listeners from container and wraps class instances
-     *
-     * @param listener - The listener to convert
-     * @param wildcard - Whether this is for a wildcard listener
-     * @returns Callable function
-     */
-    makeListener(listener, wildcard = false) {
-        // If it's a string, resolve from container
-        if (typeof listener === 'string') {
-            return this.createClassListener(listener, wildcard);
-        }
-        // If it's a function/class constructor
-        if (typeof listener === 'function') {
-            // Check if it's a class constructor (has prototype with handle method)
-            if (listener.prototype && typeof listener.prototype.handle === 'function') {
-                // It's a class constructor, instantiate and call handle
-                return (event, ...payload) => {
-                    const instance = new listener();
-                    return instance.handle(event);
-                };
-            }
-            // It's a regular function (closure), return as-is
-            return listener;
-        }
-        // If it's a class instance with handle method
-        if (typeof listener === 'object' && 'handle' in listener) {
-            const instance = listener;
-            return (event, ...payload) => {
-                return instance.handle(event);
-            };
-        }
-        throw new Error(`Invalid listener type: ${typeof listener}`);
-    }
-    /**
-     * Create a listener from a class string reference
-     *
-     * Resolves the class from the container and calls its handle method
-     *
-     * @param listener - Class name/path to resolve
-     * @param wildcard - Whether this is for a wildcard listener
-     * @returns Callable function
-     */
-    createClassListener(listener, wildcard = false) {
-        return (event, ...payload) => {
-            // Resolve the listener class from the container
-            const instance = this.container.make(listener);
-            if (!instance || typeof instance.handle !== 'function') {
-                throw new Error(`Listener [${listener}] does not have a handle method`);
-            }
-            // Call the handle method
-            return instance.handle(event);
-        };
-    }
-    /**
-     * Check if an event should broadcast
-     *
-     * This is a placeholder for future broadcasting support
-     *
-     * @param event - The event instance
-     * @param payload - The event payload
-     * @returns True if should broadcast
-     */
-    shouldBroadcast(event, payload) {
-        // Check if event has shouldBroadcast method and it returns true
-        if (typeof event.shouldBroadcast === 'function') {
-            return event.shouldBroadcast();
-        }
-        // Check if event has broadcastOn method that returns channels
-        if (typeof event.broadcastOn === 'function') {
-            const channels = event.broadcastOn();
-            return Array.isArray(channels) ? channels.length > 0 : !!channels;
-        }
-        return false;
-    }
-}
-exports.Dispatcher = Dispatcher;
-//# sourceMappingURL=Dispatcher.js.map

package/dist/Events/Dispatcher.js.map

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