@orchestr-sh/orchestr 1.6.0 → 1.7.0

package/dist/Events/Dispatcher.js

@@ -0,0 +1,359 @@
+"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 (closure), return as-is
+        if (typeof listener === 'function') {
+            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

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

package/dist/Events/Event.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Event Base Class
+ *
+ * Base class for all events in the application
+ * Provides serialization support and broadcasting capabilities
+ *
+ * @example
+ * ```typescript
+ * class UserRegistered extends Event {
+ *   constructor(public readonly user: User) {
+ *     super();
+ *   }
+ * }
+ *
+ * // Dispatch the event
+ * UserRegistered.dispatch(user);
+ * ```
+ */
+/**
+ * Abstract Event base class
+ *
+ * All application events should extend this class.
+ * It provides:
+ * - Event metadata storage
+ * - Serialization for queueing
+ * - Broadcasting support
+ * - Static dispatch methods (via Dispatchable mixin)
+ */
+export declare abstract class Event {
+    /**
+     * Properties to exclude from serialization
+     * Override in child classes to specify which properties should not be serialized
+     */
+    protected static serializable: string[];
+    /**
+     * The name of the connection the job should be sent to
+     * Used when queueing event listeners
+     */
+    connection?: string;
+    /**
+     * The name of the queue the job should be sent to
+     * Used when queueing event listeners
+     */
+    queue?: string;
+    /**
+     * The number of seconds before the job should be processed
+     * Used when queueing event listeners
+     */
+    delay?: number;
+    /**
+     * Convert event to JSON for queue serialization
+     *
+     * Serializes all public properties except those listed in the serializable array
+     *
+     * @returns Object representation of the event
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Serialize a value for JSON storage
+     *
+     * @param value - Value to serialize
+     * @returns Serialized value
+     */
+    protected serializeValue(value: any): any;
+    /**
+     * Recreate event from JSON
+     *
+     * This method should be overridden in child classes if custom deserialization is needed
+     *
+     * @param data - Serialized event data
+     * @returns Event instance
+     */
+    static fromJSON<T extends Event>(this: typeof Event & (new (...args: any[]) => T), data: Record<string, any>): T;
+    /**
+     * Deserialize a value from JSON
+     *
+     * @param value - Serialized value
+     * @returns Deserialized value
+     */
+    protected static deserializeValue(value: any): any;
+    /**
+     * Get the broadcast channel name(s)
+     *
+     * Override in child classes to specify which channels this event should broadcast on
+     *
+     * @returns Channel name(s) or empty array for no broadcasting
+     *
+     * @example
+     * ```typescript
+     * broadcastOn(): string | string[] {
+     *   return 'users.' + this.user.id;
+     * }
+     * ```
+     */
+    broadcastOn(): string | string[];
+    /**
+     * Get the data to broadcast
+     *
+     * Override in child classes to customize the broadcast payload
+     * By default, returns all public properties
+     *
+     * @returns Data to broadcast
+     *
+     * @example
+     * ```typescript
+     * broadcastWith(): Record<string, any> {
+     *   return {
+     *     userId: this.user.id,
+     *     userName: this.user.name,
+     *   };
+     * }
+     * ```
+     */
+    broadcastWith(): Record<string, any>;
+    /**
+     * Get the broadcast event name
+     *
+     * Override in child classes to customize the event name sent to clients
+     * By default, returns the class name
+     *
+     * @returns Event name for broadcasting
+     *
+     * @example
+     * ```typescript
+     * broadcastAs(): string {
+     *   return 'user.registered';
+     * }
+     * ```
+     */
+    broadcastAs(): string;
+    /**
+     * Determine if this event should broadcast
+     *
+     * Override in child classes to conditionally broadcast events
+     *
+     * @returns True if event should broadcast
+     */
+    shouldBroadcast(): boolean;
+}
+//# sourceMappingURL=Event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Event.d.ts","sourceRoot":"","sources":["../../src/Events/Event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;GASG;AACH,8BAAsB,KAAK;IACzB;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAM;IAE7C;;;OAGG;IACI,UAAU,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACI,KAAK,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACI,KAAK,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;OAMG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAkC7B;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;IAqCzC;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,OAAO,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC;IAchH;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG;IAkClD;;;;;;;;;;;;;OAaG;IACH,WAAW,IAAI,MAAM,GAAG,MAAM,EAAE;IAIhC;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IA0BpC;;;;;;;;;;;;;;OAcG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;;OAMG;IACH,eAAe,IAAI,OAAO;CAI3B"}