@orchestr-sh/orchestr 1.6.0 → 1.7.0

package/dist/Events/PendingDispatch.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingDispatch = void 0;
+/**
+ * Pending Dispatch
+ *
+ * A deferred dispatch helper that allows chaining configuration
+ * before actually dispatching an event.
+ *
+ * This is useful for building fluent APIs around event dispatching,
+ * similar to Laravel's job dispatching.
+ *
+ * @example
+ * ```typescript
+ * // Defer dispatch with configuration
+ * const pending = new PendingDispatch(dispatcher, new UserRegistered(user));
+ * pending
+ *   .onConnection('redis')
+ *   .onQueue('notifications')
+ *   .delay(60)
+ *   .dispatch();
+ *
+ * // Or dispatch immediately with configuration
+ * PendingDispatch.for(dispatcher, new OrderPlaced(order))
+ *   .delay(300)
+ *   .dispatch();
+ * ```
+ */
+class PendingDispatch {
+    dispatcher;
+    event;
+    /**
+     * Event configuration options
+     */
+    options = {};
+    /**
+     * Create a new pending dispatch instance
+     *
+     * @param dispatcher - The event dispatcher
+     * @param event - The event to dispatch
+     */
+    constructor(dispatcher, event) {
+        this.dispatcher = dispatcher;
+        this.event = event;
+    }
+    /**
+     * Static factory method for fluent API
+     *
+     * @param dispatcher - The event dispatcher
+     * @param event - The event to dispatch
+     * @returns PendingDispatch instance
+     */
+    static for(dispatcher, event) {
+        return new PendingDispatch(dispatcher, event);
+    }
+    /**
+     * Set the queue connection for the event
+     *
+     * Only applicable if the event's listeners are queued
+     *
+     * @param connection - Connection name
+     * @returns This instance for chaining
+     */
+    onConnection(connection) {
+        this.options.connection = connection;
+        return this;
+    }
+    /**
+     * Set the queue for the event
+     *
+     * Only applicable if the event's listeners are queued
+     *
+     * @param queue - Queue name
+     * @returns This instance for chaining
+     */
+    onQueue(queue) {
+        this.options.queue = queue;
+        return this;
+    }
+    /**
+     * Set the delay before dispatching
+     *
+     * @param delay - Delay in seconds
+     * @returns This instance for chaining
+     */
+    delay(delay) {
+        this.options.delay = delay;
+        return this;
+    }
+    /**
+     * Set the delay before dispatching (alias for delay)
+     *
+     * @param delay - Delay in seconds
+     * @returns This instance for chaining
+     */
+    afterDelay(delay) {
+        return this.delay(delay);
+    }
+    /**
+     * Apply the configured options to the event
+     *
+     * @returns The configured event
+     */
+    applyOptions() {
+        if (this.options.connection) {
+            this.event.connection = this.options.connection;
+        }
+        if (this.options.queue) {
+            this.event.queue = this.options.queue;
+        }
+        if (this.options.delay) {
+            this.event.delay = this.options.delay;
+        }
+        return this.event;
+    }
+    /**
+     * Dispatch the event to all listeners
+     *
+     * @returns Array of results from listeners
+     */
+    dispatch() {
+        const event = this.applyOptions();
+        return this.dispatcher.dispatch(event);
+    }
+    /**
+     * Dispatch the event until the first listener returns a non-null response
+     *
+     * @returns The first non-null response
+     */
+    until() {
+        const event = this.applyOptions();
+        return this.dispatcher.until(event);
+    }
+    /**
+     * Conditionally dispatch the event
+     *
+     * @param condition - Boolean or function returning boolean
+     * @returns Array of results or empty array
+     */
+    dispatchIf(condition) {
+        const shouldDispatch = typeof condition === 'function' ? condition() : condition;
+        if (shouldDispatch) {
+            return this.dispatch();
+        }
+        return [];
+    }
+    /**
+     * Dispatch unless the condition is true
+     *
+     * @param condition - Boolean or function returning boolean
+     * @returns Array of results or empty array
+     */
+    dispatchUnless(condition) {
+        const shouldNotDispatch = typeof condition === 'function' ? condition() : condition;
+        if (!shouldNotDispatch) {
+            return this.dispatch();
+        }
+        return [];
+    }
+}
+exports.PendingDispatch = PendingDispatch;
+//# sourceMappingURL=PendingDispatch.js.map

package/dist/Events/PendingDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingDispatch.js","sourceRoot":"","sources":["../../src/Events/PendingDispatch.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAa,eAAe;IAiBd;IACA;IAjBZ;;OAEG;IACO,OAAO,GAIb,EAAE,CAAC;IAEP;;;;;OAKG;IACH,YACY,UAA8B,EAC9B,KAAY;QADZ,eAAU,GAAV,UAAU,CAAoB;QAC9B,UAAK,GAAL,KAAK,CAAO;IACrB,CAAC;IAEJ;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,UAA8B,EAAE,KAAY;QACrD,OAAO,IAAI,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,UAAkB;QAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACO,YAAY;QACpB,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAClD,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,SAAoC;QAC7C,MAAM,cAAc,GAAG,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAEjF,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,SAAoC;QACjD,MAAM,iBAAiB,GAAG,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAEpF,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AAvJD,0CAuJC"}

package/dist/Events/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Events Module
+ *
+ * Provides event dispatching and listener management following Laravel's event system
+ */
+export { Event } from './Event';
+export { Dispatcher } from './Dispatcher';
+export { EventServiceProvider } from './EventServiceProvider';
+export { Dispatchable, applyDispatchable } from './Concerns/Dispatchable';
+export type { DispatcherContract } from './Contracts/Dispatcher';
+export type { EventListener, EventSubscriber, ListenerInterface, ListenerClosure, EventPayload, QueuedListener } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,cAAc,EACf,MAAM,SAAS,CAAC"}

package/dist/Events/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Events Module
+ *
+ * Provides event dispatching and listener management following Laravel's event system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyDispatchable = exports.Dispatchable = exports.EventServiceProvider = exports.Dispatcher = exports.Event = void 0;
+// Core Event Classes
+var Event_1 = require("./Event");
+Object.defineProperty(exports, "Event", { enumerable: true, get: function () { return Event_1.Event; } });
+var Dispatcher_1 = require("./Dispatcher");
+Object.defineProperty(exports, "Dispatcher", { enumerable: true, get: function () { return Dispatcher_1.Dispatcher; } });
+var EventServiceProvider_1 = require("./EventServiceProvider");
+Object.defineProperty(exports, "EventServiceProvider", { enumerable: true, get: function () { return EventServiceProvider_1.EventServiceProvider; } });
+// Concerns/Mixins
+var Dispatchable_1 = require("./Concerns/Dispatchable");
+Object.defineProperty(exports, "Dispatchable", { enumerable: true, get: function () { return Dispatchable_1.Dispatchable; } });
+Object.defineProperty(exports, "applyDispatchable", { enumerable: true, get: function () { return Dispatchable_1.applyDispatchable; } });
+//# sourceMappingURL=index.js.map

package/dist/Events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Events/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qBAAqB;AACrB,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,kBAAkB;AAClB,wDAA0E;AAAjE,4GAAA,YAAY,OAAA;AAAE,iHAAA,iBAAiB,OAAA"}

package/dist/Events/types.d.ts

@@ -0,0 +1,77 @@
+import type { Event } from './Event';
+import type { DispatcherContract } from './Contracts/Dispatcher';
+/**
+ * Listener Interface
+ *
+ * Defines the contract for class-based event listeners.
+ * Listeners must implement a handle method that receives an event.
+ *
+ * @template TEvent - The event type this listener handles
+ */
+export interface ListenerInterface<TEvent extends Event = Event> {
+    /**
+     * Handle the event
+     *
+     * @param event - The event instance to handle
+     * @returns void, false to stop propagation, or a Promise
+     */
+    handle(event: TEvent): void | false | Promise<void | false>;
+}
+/**
+ * Listener Closure Type
+ *
+ * A function that handles an event. Can return false to stop propagation.
+ *
+ * @template TEvent - The event type this closure handles
+ */
+export type ListenerClosure<TEvent extends Event = Event> = (event: TEvent) => void | false | Promise<void | false>;
+/**
+ * Event Listener Type
+ *
+ * Can be one of:
+ * - A class instance implementing ListenerInterface
+ * - A closure function
+ * - A string reference to resolve from the container
+ *
+ * @template TEvent - The event type this listener handles
+ */
+export type EventListener<TEvent extends Event = Event> = ListenerInterface<TEvent> | ListenerClosure<TEvent> | string;
+/**
+ * Event Subscriber Interface
+ *
+ * Subscribers can register multiple event listeners at once.
+ * They return a mapping of event names to listener methods.
+ */
+export interface EventSubscriber {
+    /**
+     * Register event listeners
+     *
+     * @param events - The event dispatcher instance
+     * @returns Mapping of event names to listener methods/closures
+     */
+    subscribe(events: DispatcherContract): void | Record<string, string | string[]>;
+}
+/**
+ * Event Payload Type
+ *
+ * Additional arguments passed when dispatching events
+ */
+export type EventPayload = any[];
+/**
+ * Queued Listener Configuration
+ *
+ * Metadata for listeners that should be queued
+ */
+export interface QueuedListener {
+    /** The listener class name */
+    class: string;
+    /** The event instance */
+    event: Event;
+    /** Number of times to retry */
+    tries: number;
+    /** Timeout in seconds */
+    timeout: number;
+    /** Delay before retrying (seconds or array of delays) */
+    backoff: number | number[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Events/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK;IAC7D;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;CAC7D;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,IACtD,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK,IAClD,iBAAiB,CAAC,MAAM,CAAC,GACzB,eAAe,CAAC,MAAM,CAAC,GACvB,MAAM,CAAC;AAEX;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CACjF;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,KAAK,EAAE,KAAK,CAAC;IAEb,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,yDAAyD;IACzD,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B"}

package/dist/Events/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/Events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/Events/types.ts"],"names":[],"mappings":""}

package/dist/Facades/DB.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DB.d.ts","sourceRoot":"","sources":["../../src/Facades/DB.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,eAAO,MAAM,EAAE,KAkCb,CAAC"}
+{"version":3,"file":"DB.d.ts","sourceRoot":"","sources":["../../src/Facades/DB.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,eAAO,MAAM,EAAE,KAgCb,CAAC"}

package/dist/Facades/DB.js.map

@@ -1 +1 @@
-{"version":3,"file":"DB.js","sourceRoot":"","sources":["../../src/Facades/DB.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,8CAA2C;AAG3C,MAAM,QAAS,SAAQ,eAAM;IACjB,MAAM,CAAC,iBAAiB;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,wCAAwC;AAC3B,QAAA,EAAE,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE;IACpC,GAAG,CAAC,MAAW,EAAE,IAAY;QAC3B,+CAA+C;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,EAAqB,CAAC;QAEvD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;QACJ,CAAC;QAED,oDAAoD;QACpD,IAAI,IAAI,IAAI,OAAQ,IAAY,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAE,IAAY,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACzB,OAAQ,IAAY,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,6DAA6D;QAC7D,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnE,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAErC,IAAI,UAAU,IAAI,OAAQ,UAAkB,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YAClE,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAE,UAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,OAAQ,UAAkB,EAAE,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"DB.js","sourceRoot":"","sources":["../../src/Facades/DB.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,8CAA2C;AAG3C,MAAM,QAAS,SAAQ,eAAM;IACjB,MAAM,CAAC,iBAAiB;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,wCAAwC;AAC3B,QAAA,EAAE,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE;IACpC,GAAG,CAAC,MAAW,EAAE,IAAY;QAC3B,+CAA+C;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,EAAqB,CAAC;QAEvD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;QACnH,CAAC;QAED,oDAAoD;QACpD,IAAI,IAAI,IAAI,OAAQ,IAAY,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YACtD,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAE,IAAY,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACzB,OAAQ,IAAY,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,6DAA6D;QAC7D,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnE,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAErC,IAAI,UAAU,IAAI,OAAQ,UAAkB,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YAClE,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAE,UAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC;QAED,OAAQ,UAAkB,EAAE,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF,CAAC,CAAC"}

package/dist/Facades/Event.d.ts

@@ -0,0 +1,200 @@
+import { Facade } from '../Support/Facade';
+import type { Dispatcher } from '../Events/Dispatcher';
+import { EventFake } from '../Support/Testing/Fakes/EventFake';
+import type { Event as EventClass } from '../Events/Event';
+import type { EventListener } from '../Events/types';
+/**
+ * Event Facade
+ *
+ * Provides static access to the event dispatcher for listening to and dispatching events.
+ * Includes testing utilities for faking events in tests.
+ *
+ * @example
+ * ```typescript
+ * // Listen to events
+ * Event.listen(UserRegistered, SendWelcomeEmail);
+ * Event.listen('user.*', (event) => console.log(event));
+ *
+ * // Dispatch events
+ * Event.dispatch(new UserRegistered(user));
+ * Event.dispatch('user.registered', [user]);
+ *
+ * // Dispatch until first non-null response
+ * const result = Event.until(new ValidateUser(user));
+ *
+ * // Testing - Fake all events
+ * Event.fake();
+ * // Your code that dispatches events
+ * Event.assertDispatched(UserRegistered);
+ * Event.assertDispatchedTimes(UserRegistered, 2);
+ *
+ * // Fake specific events
+ * Event.fake([UserRegistered, OrderPlaced]);
+ *
+ * // Fake all except specific events
+ * Event.fakeExcept([UserDeleted]);
+ * ```
+ */
+declare class EventFacadeClass extends Facade {
+    protected static getFacadeAccessor(): string;
+    /**
+     * Fake events for testing
+     *
+     * Replaces the real event dispatcher with a fake that records all
+     * dispatched events instead of calling listeners. Returns the fake
+     * instance for making assertions.
+     *
+     * @param events - Optional array of events to fake (fakes all if not provided)
+     * @returns EventFake instance for assertions
+     *
+     * @example
+     * ```typescript
+     * // Fake all events
+     * const fake = Event.fake();
+     * // Your code
+     * fake.assertDispatched(UserRegistered);
+     *
+     * // Fake specific events only
+     * Event.fake([UserRegistered, OrderPlaced]);
+     * ```
+     */
+    static fake(events?: (string | (new (...args: any[]) => EventClass))[]): EventFake;
+    /**
+     * Fake all events except the specified ones
+     *
+     * All events will be faked except those in the provided array,
+     * which will dispatch normally.
+     *
+     * @param events - Events that should NOT be faked
+     * @returns EventFake instance for assertions
+     *
+     * @example
+     * ```typescript
+     * // Fake all events except UserDeleted
+     * Event.fakeExcept([UserDeleted]);
+     * // UserDeleted will dispatch normally, all others will be faked
+     * ```
+     */
+    static fakeExcept(events: (string | (new (...args: any[]) => EventClass))[]): EventFake;
+    /**
+     * Fake events only for the duration of a callback
+     *
+     * Temporarily replaces the event dispatcher with a fake, executes
+     * the callback, then restores the original dispatcher. Useful for
+     * scoping fakes to specific test blocks.
+     *
+     * @param callback - Function to execute with faked events
+     * @returns Result of the callback and the fake instance
+     *
+     * @example
+     * ```typescript
+     * const [result, fake] = await Event.fakeFor(async () => {
+     *   await someService.createUser();
+     *   return 'done';
+     * });
+     *
+     * fake.assertDispatched(UserRegistered);
+     * expect(result).toBe('done');
+     * ```
+     */
+    static fakeFor<T>(callback: (fake: EventFake) => T | Promise<T>): Promise<[T, EventFake]>;
+    /**
+     * Assert that an event was dispatched
+     *
+     * Can only be called after Event.fake() has been called.
+     *
+     * @param event - The event name or class
+     * @param callback - Optional callback to filter events
+     *
+     * @example
+     * ```typescript
+     * Event.fake();
+     * // Your code
+     * Event.assertDispatched(UserRegistered);
+     * Event.assertDispatched(UserRegistered, (event) => event.user.email === 'test@example.com');
+     * ```
+     */
+    static assertDispatched(event: string | (new (...args: any[]) => EventClass), callback?: (event: EventClass) => boolean): void;
+    /**
+     * Assert that an event was NOT dispatched
+     *
+     * Can only be called after Event.fake() has been called.
+     *
+     * @param event - The event name or class
+     * @param callback - Optional callback to filter events
+     *
+     * @example
+     * ```typescript
+     * Event.fake();
+     * // Your code
+     * Event.assertNotDispatched(UserDeleted);
+     * ```
+     */
+    static assertNotDispatched(event: string | (new (...args: any[]) => EventClass), callback?: (event: EventClass) => boolean): void;
+    /**
+     * Assert that an event was dispatched a specific number of times
+     *
+     * Can only be called after Event.fake() has been called.
+     *
+     * @param event - The event name or class
+     * @param times - Expected number of dispatches
+     *
+     * @example
+     * ```typescript
+     * Event.fake();
+     * // Your code
+     * Event.assertDispatchedTimes(UserRegistered, 3);
+     * ```
+     */
+    static assertDispatchedTimes(event: string | (new (...args: any[]) => EventClass), times: number): void;
+    /**
+     * Assert that no events were dispatched
+     *
+     * Can only be called after Event.fake() has been called.
+     *
+     * @example
+     * ```typescript
+     * Event.fake();
+     * // Your code that shouldn't dispatch events
+     * Event.assertNothingDispatched();
+     * ```
+     */
+    static assertNothingDispatched(): void;
+    /**
+     * Assert that a listener is registered for an event
+     *
+     * @param event - The event name or class
+     * @param listener - Optional specific listener to check for
+     *
+     * @example
+     * ```typescript
+     * Event.fake();
+     * Event.listen(UserRegistered, SendWelcomeEmail);
+     * Event.assertListening(UserRegistered);
+     * Event.assertListening(UserRegistered, SendWelcomeEmail);
+     * ```
+     */
+    static assertListening(event: string | (new (...args: any[]) => EventClass), listener?: string | EventListener): void;
+    /**
+     * Get the fake instance
+     *
+     * @returns The EventFake instance
+     * @throws Error if Event.fake() hasn't been called
+     */
+    protected static getFakeInstance(): EventFake;
+    /**
+     * Check if the event dispatcher is currently faked
+     *
+     * @returns true if using EventFake
+     */
+    static isFaked(): boolean;
+}
+/**
+ * Export facade with proper typing
+ */
+export declare const Event: typeof EventFacadeClass & Dispatcher;
+/**
+ * Re-export EventFake for direct use
+ */
+export { EventFake };
+//# sourceMappingURL=Event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Event.d.ts","sourceRoot":"","sources":["../../src/Facades/Event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,cAAM,gBAAiB,SAAQ,MAAM;IACnC,SAAS,CAAC,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAG5C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,CAAC,EAAE,GAAG,SAAS;IA2BlF;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,CAAC,EAAE,GAAG,SAAS;IAwBvF;;;;;;;;;;;;;;;;;;;;OAoBG;WACU,OAAO,CAAC,CAAC,EACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC5C,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAkC1B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,gBAAgB,CACrB,KAAK,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,EACpD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,GACxC,IAAI;IAKP;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,mBAAmB,CACxB,KAAK,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,EACpD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,GACxC,IAAI;IAKP;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,qBAAqB,CAC1B,KAAK,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,EACpD,KAAK,EAAE,MAAM,GACZ,IAAI;IAKP;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,uBAAuB,IAAI,IAAI;IAKtC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC,EACpD,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,GAChC,IAAI;IAKP;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,eAAe,IAAI,SAAS;IAa7C;;;;OAIG;IACH,MAAM,CAAC,OAAO,IAAI,OAAO;CAS1B;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,EAAuB,OAAO,gBAAgB,GAAG,UAAU,CAAC;AAE9E;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,CAAC"}