@orchestr-sh/orchestr 1.6.1 → 1.7.0

package/dist/Facades/Event.js

@@ -0,0 +1,331 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventFake = exports.Event = void 0;
+const Facade_1 = require("../Support/Facade");
+const EventFake_1 = require("../Support/Testing/Fakes/EventFake");
+Object.defineProperty(exports, "EventFake", { enumerable: true, get: function () { return EventFake_1.EventFake; } });
+/**
+ * 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]);
+ * ```
+ */
+class EventFacadeClass extends Facade_1.Facade {
+    static getFacadeAccessor() {
+        return 'events';
+    }
+    /**
+     * 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) {
+        const app = this.getFacadeApplication();
+        const fake = new EventFake_1.EventFake(app);
+        if (events && events.length > 0) {
+            // Create selective fake that only intercepts specified events
+            const eventNames = events.map(e => typeof e === 'string' ? e : e.name);
+            fake.setFakedEvents(eventNames);
+            // Store original dispatcher for pass-through
+            try {
+                const originalDispatcher = app.make('events');
+                fake.setOriginalDispatcher(originalDispatcher);
+            }
+            catch (error) {
+                // Dispatcher not registered yet, that's okay
+            }
+        }
+        // Replace the events binding with the fake
+        app.instance('events', fake);
+        this.clearResolvedInstance('events');
+        return fake;
+    }
+    /**
+     * 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) {
+        const app = this.getFacadeApplication();
+        const fake = new EventFake_1.EventFake(app);
+        const eventNames = events.map(e => typeof e === 'string' ? e : e.name);
+        fake.setExceptedEvents(eventNames);
+        // Store original dispatcher for pass-through
+        try {
+            const originalDispatcher = app.make('events');
+            fake.setOriginalDispatcher(originalDispatcher);
+        }
+        catch (error) {
+            // Dispatcher not registered yet, that's okay
+        }
+        // Replace the events binding with the fake
+        app.instance('events', fake);
+        this.clearResolvedInstance('events');
+        return fake;
+    }
+    /**
+     * 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 async fakeFor(callback) {
+        const app = this.getFacadeApplication();
+        // Store the original binding
+        const originalBinding = app.bound('events');
+        let originalDispatcher;
+        if (originalBinding) {
+            try {
+                originalDispatcher = app.make('events');
+            }
+            catch (error) {
+                // Ignore if can't resolve
+            }
+        }
+        // Create and install fake
+        const fake = this.fake();
+        try {
+            const result = await callback(fake);
+            return [result, fake];
+        }
+        finally {
+            // Restore original dispatcher
+            if (originalDispatcher) {
+                app.instance('events', originalDispatcher);
+            }
+            else {
+                // Re-register the singleton binding
+                const { Dispatcher } = await Promise.resolve().then(() => __importStar(require('../Events/Dispatcher')));
+                app.singleton('events', (container) => new Dispatcher(container));
+            }
+            this.clearResolvedInstance('events');
+        }
+    }
+    /**
+     * 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, callback) {
+        const fake = this.getFakeInstance();
+        fake.assertDispatched(event, callback);
+    }
+    /**
+     * 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, callback) {
+        const fake = this.getFakeInstance();
+        fake.assertNotDispatched(event, callback);
+    }
+    /**
+     * 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, times) {
+        const fake = this.getFakeInstance();
+        fake.assertDispatchedTimes(event, times);
+    }
+    /**
+     * 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() {
+        const fake = this.getFakeInstance();
+        fake.assertNothingDispatched();
+    }
+    /**
+     * 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, listener) {
+        const fake = this.getFakeInstance();
+        fake.assertListening(event, listener);
+    }
+    /**
+     * Get the fake instance
+     *
+     * @returns The EventFake instance
+     * @throws Error if Event.fake() hasn't been called
+     */
+    static getFakeInstance() {
+        const app = this.getFacadeApplication();
+        const instance = app.make('events');
+        if (!(instance instanceof EventFake_1.EventFake)) {
+            throw new Error('Event facade is not faked. Call Event.fake() before making assertions.');
+        }
+        return instance;
+    }
+    /**
+     * Check if the event dispatcher is currently faked
+     *
+     * @returns true if using EventFake
+     */
+    static isFaked() {
+        try {
+            const app = this.getFacadeApplication();
+            const instance = app.make('events');
+            return instance instanceof EventFake_1.EventFake;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+/**
+ * Export facade with proper typing
+ */
+exports.Event = EventFacadeClass;
+//# sourceMappingURL=Event.js.map

package/dist/Facades/Event.js.map

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

package/dist/Foundation/Application.d.ts

@@ -9,6 +9,7 @@ export declare class Application extends Container {
     private booted;
     private serviceProviders;
     private loadedProviders;
+    private eventDiscoveryPaths;
     constructor(basePath?: string);
     /**
      * Register the basic bindings into the container
@@ -93,5 +94,37 @@ export declare class Application extends Container {
      * Determine if the application has been bootstrapped before
      */
     hasBeenBootstrapped(): boolean;
+    /**
+     * Configure event discovery paths
+     *
+     * Allows customizing which directories should be scanned for event listeners
+     * during automatic discovery.
+     *
+     * @param {Object} options - Configuration options
+     * @param {string[]} options.discover - Array of directory paths to scan for listeners
+     * @returns {this} The application instance for chaining
+     *
+     * @example
+     * ```typescript
+     * app.withEvents({
+     *   discover: [
+     *     app.path('Listeners'),
+     *     app.path('Domain/Listeners')
+     *   ]
+     * })
+     * ```
+     */
+    withEvents(options?: {
+        discover?: string[];
+    }): this;
+    /**
+     * Get the event discovery paths
+     *
+     * Returns the configured paths for event listener discovery.
+     * If no paths are configured, defaults to the 'Listeners' directory.
+     *
+     * @returns {string[]} Array of absolute directory paths
+     */
+    getEventDiscoveryPaths(): string[];
 }
 //# sourceMappingURL=Application.d.ts.map

package/dist/Foundation/Application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../src/Foundation/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,eAAe,CAAmC;gBAE9C,QAAQ,GAAE,MAAsB;IAU5C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAYpC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,IAAI,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAI/B,UAAU,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAIrC,YAAY,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAIvC,WAAW,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAItC,UAAU,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAIrC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,CAAC,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAAC,GAAG,eAAe;IA0BlG;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAAC,CAAC,GAAG,IAAI;IAIxG;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;YACW,YAAY;IAS1B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAAyB;IAErD,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAIjC;;OAEG;IACH,mBAAmB,IAAI,OAAO;CAG/B"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../src/Foundation/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,mBAAmB,CAAgB;gBAE/B,QAAQ,GAAE,MAAsB;IAU5C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAYpC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,IAAI,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAI/B,UAAU,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAIrC,YAAY,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAIvC,WAAW,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAItC,UAAU,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM;IAIrC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,CAAC,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAAC,GAAG,eAAe;IA0BlG;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAAC,CAAC,GAAG,IAAI;IAIxG;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B;;OAEG;YACW,YAAY;IAS1B;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAAyB;IAErD,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIvC;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAIjC;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,IAAI;IAOvD;;;;;;;OAOG;IACH,sBAAsB,IAAI,MAAM,EAAE;CAKnC"}

package/dist/Foundation/Application.js

@@ -12,6 +12,7 @@ class Application extends Container_1.Container {
     booted = false;
     serviceProviders = [];
     loadedProviders = new Map();
+    eventDiscoveryPaths = [];
     constructor(basePath = process.cwd()) {
         super();
         this.basePath = basePath;
@@ -187,6 +188,45 @@ class Application extends Container_1.Container {
     hasBeenBootstrapped() {
         return this.booted;
     }
+    /**
+     * Configure event discovery paths
+     *
+     * Allows customizing which directories should be scanned for event listeners
+     * during automatic discovery.
+     *
+     * @param {Object} options - Configuration options
+     * @param {string[]} options.discover - Array of directory paths to scan for listeners
+     * @returns {this} The application instance for chaining
+     *
+     * @example
+     * ```typescript
+     * app.withEvents({
+     *   discover: [
+     *     app.path('Listeners'),
+     *     app.path('Domain/Listeners')
+     *   ]
+     * })
+     * ```
+     */
+    withEvents(options = {}) {
+        if (options.discover) {
+            this.eventDiscoveryPaths = options.discover;
+        }
+        return this;
+    }
+    /**
+     * Get the event discovery paths
+     *
+     * Returns the configured paths for event listener discovery.
+     * If no paths are configured, defaults to the 'Listeners' directory.
+     *
+     * @returns {string[]} Array of absolute directory paths
+     */
+    getEventDiscoveryPaths() {
+        return this.eventDiscoveryPaths.length > 0
+            ? this.eventDiscoveryPaths
+            : [this.path('Listeners')];
+    }
 }
 exports.Application = Application;
 //# sourceMappingURL=Application.js.map

package/dist/Foundation/Application.js.map

@@ -1 +1 @@
-{"version":3,"file":"Application.js","sourceRoot":"","sources":["../../src/Foundation/Application.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,gDAAkD;AAElD;;;GAGG;AACH,MAAa,WAAY,SAAQ,qBAAS;IAChC,QAAQ,CAAS;IACjB,MAAM,GAAY,KAAK,CAAC;IACxB,gBAAgB,GAAsB,EAAE,CAAC;IACzC,eAAe,GAAyB,IAAI,GAAG,EAAE,CAAC;IAE1D,YAAY,WAAmB,OAAO,CAAC,GAAG,EAAE;QAC1C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,4BAA4B,EAAE,CAAC;QAEpC,2DAA2D;QAC3D,IAAA,sBAAY,EAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,oBAAoB;QAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,qBAAS,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,4BAA4B;QAClC,MAAM,OAAO,GAAgC;YAC3C,GAAG,EAAE,CAAC,aAAa,CAAC;SACrB,CAAC;QAEF,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe,EAAE;QACpB,OAAO,GAAG,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,OAAe,EAAE;QAC1B,OAAO,GAAG,IAAI,CAAC,QAAQ,UAAU,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC5D,CAAC;IAED,YAAY,CAAC,OAAe,EAAE;QAC5B,OAAO,GAAG,IAAI,CAAC,QAAQ,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,WAAW,CAAC,OAAe,EAAE;QAC3B,OAAO,GAAG,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,OAAe,EAAE;QAC1B,OAAO,GAAG,IAAI,CAAC,QAAQ,UAAU,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAuE;QAC9E,yCAAyC;QACzC,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;YACnC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,8BAA8B;QAC9B,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC;QAC/C,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,sCAAsC;QACtC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAEpB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAE7C,2DAA2D;QAC3D,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,SAA+E;QAC/F,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,QAAyB;QAClD,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;YACvD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,MAAM,MAAM,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;OAGG;IACK,oBAAoB,GAAsB,EAAE,CAAC;IAErD,WAAW,CAAC,QAAoB;QAC9B,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,YAAY,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAtND,kCAsNC"}
+{"version":3,"file":"Application.js","sourceRoot":"","sources":["../../src/Foundation/Application.ts"],"names":[],"mappings":"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"}

package/dist/Listeners/Contracts/ShouldQueue.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Should Queue Interface
+ *
+ * Marks a listener as queueable, allowing it to be processed asynchronously
+ * through the queue system instead of synchronously during event dispatch.
+ *
+ * @example
+ * ```typescript
+ * class SendWelcomeEmail implements ShouldQueue {
+ *   public connection = 'redis';
+ *   public queue = 'emails';
+ *   public tries = 3;
+ *   public timeout = 60;
+ *
+ *   async handle(event: UserRegistered): Promise<void> {
+ *     await this.emailService.send(event.user.email, 'Welcome!');
+ *   }
+ *
+ *   async failed(event: UserRegistered, error: Error): Promise<void> {
+ *     console.error('Failed to send welcome email:', error);
+ *   }
+ * }
+ * ```
+ */
+export interface ShouldQueue {
+    /**
+     * The name of the connection the job should be sent to
+     *
+     * @example 'redis', 'database', 'sqs'
+     */
+    connection?: string;
+    /**
+     * The name of the queue the job should be sent to
+     *
+     * @example 'emails', 'notifications', 'default'
+     */
+    queue?: string;
+    /**
+     * The number of seconds before the job should be processed
+     */
+    delay?: number;
+    /**
+     * The number of times the job may be attempted
+     *
+     * @default 1
+     */
+    tries?: number;
+    /**
+     * The maximum number of seconds the job can run
+     *
+     * @default 60
+     */
+    timeout?: number;
+    /**
+     * The number of seconds to wait before retrying the job
+     * Can be a single value or an array for progressive backoff
+     *
+     * @example
+     * ```typescript
+     * backoff = 10; // Wait 10 seconds between retries
+     * backoff = [10, 30, 60]; // Progressive backoff
+     * ```
+     */
+    backoff?: number | number[];
+    /**
+     * Determine the connection to send the job to
+     *
+     * @returns The connection name
+     *
+     * @example
+     * ```typescript
+     * viaConnection(): string {
+     *   return this.isUrgent ? 'redis' : 'database';
+     * }
+     * ```
+     */
+    viaConnection?(): string;
+    /**
+     * Determine the queue to send the job to
+     *
+     * @returns The queue name
+     *
+     * @example
+     * ```typescript
+     * viaQueue(): string {
+     *   return this.priority === 'high' ? 'priority' : 'default';
+     * }
+     * ```
+     */
+    viaQueue?(): string;
+    /**
+     * Determine the delay for the queued job
+     *
+     * @param event - The event that triggered this listener
+     * @returns Delay in seconds
+     *
+     * @example
+     * ```typescript
+     * withDelay(event: UserRegistered): number {
+     *   return event.user.isPremium ? 0 : 300; // Premium users get instant processing
+     * }
+     * ```
+     */
+    withDelay?(event: Event): number;
+    /**
+     * Determine if the listener should be queued
+     *
+     * @param event - The event that triggered this listener
+     * @returns True if should be queued, false to execute synchronously
+     *
+     * @example
+     * ```typescript
+     * shouldQueue(event: OrderPlaced): boolean {
+     *   return event.order.total > 1000; // Only queue for large orders
+     * }
+     * ```
+     */
+    shouldQueue?(event: Event): boolean;
+    /**
+     * Handle a job failure
+     *
+     * @param event - The event that triggered this listener
+     * @param exception - The exception that caused the failure
+     *
+     * @example
+     * ```typescript
+     * async failed(event: UserRegistered, error: Error): Promise<void> {
+     *   await this.logError(event.user.id, error);
+     *   await this.notifyAdmin(error);
+     * }
+     * ```
+     */
+    failed?(event: Event, exception: Error): void | Promise<void>;
+}
+/**
+ * Type guard to check if a listener implements ShouldQueue
+ *
+ * @param listener - The listener to check
+ * @returns True if listener implements ShouldQueue
+ */
+export declare function isShouldQueue(listener: any): listener is ShouldQueue;
+//# sourceMappingURL=ShouldQueue.d.ts.map

package/dist/Listeners/Contracts/ShouldQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShouldQueue.d.ts","sourceRoot":"","sources":["../../../src/Listeners/Contracts/ShouldQueue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE5B;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,IAAI,MAAM,CAAC;IAEzB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,MAAM,CAAC;IAEpB;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IAEjC;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IAEpC;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,IAAI,WAAW,CAapE"}

package/dist/Listeners/Contracts/ShouldQueue.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isShouldQueue = isShouldQueue;
+/**
+ * Type guard to check if a listener implements ShouldQueue
+ *
+ * @param listener - The listener to check
+ * @returns True if listener implements ShouldQueue
+ */
+function isShouldQueue(listener) {
+    return (listener !== null &&
+        typeof listener === 'object' &&
+        ('connection' in listener ||
+            'queue' in listener ||
+            'tries' in listener ||
+            typeof listener.viaConnection === 'function' ||
+            typeof listener.viaQueue === 'function' ||
+            typeof listener.shouldQueue === 'function'));
+}
+//# sourceMappingURL=ShouldQueue.js.map

package/dist/Listeners/Contracts/ShouldQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShouldQueue.js","sourceRoot":"","sources":["../../../src/Listeners/Contracts/ShouldQueue.ts"],"names":[],"mappings":";;AAuJA,sCAaC;AAnBD;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,QAAa;IACzC,OAAO,CACL,QAAQ,KAAK,IAAI;QACjB,OAAO,QAAQ,KAAK,QAAQ;QAC5B,CACE,YAAY,IAAI,QAAQ;YACxB,OAAO,IAAI,QAAQ;YACnB,OAAO,IAAI,QAAQ;YACnB,OAAO,QAAQ,CAAC,aAAa,KAAK,UAAU;YAC5C,OAAO,QAAQ,CAAC,QAAQ,KAAK,UAAU;YACvC,OAAO,QAAQ,CAAC,WAAW,KAAK,UAAU,CAC3C,CACF,CAAC;AACJ,CAAC"}

package/dist/Listeners/Contracts/ShouldQueueAfterCommit.d.ts

@@ -0,0 +1,24 @@
+import type { ShouldQueue } from './ShouldQueue';
+/**
+ * Should Queue After Commit Interface
+ *
+ * Marker interface for queued listeners that should only be dispatched
+ * to the queue after database transactions have been committed.
+ *
+ * This combines the behavior of ShouldQueue with transaction awareness.
+ *
+ * @example
+ * ```typescript
+ * export class SendWelcomeEmail implements ShouldQueueAfterCommit {
+ *   public tries = 3;
+ *   public timeout = 30;
+ *
+ *   handle(event: UserRegistered): void {
+ *     // This will only run if the database transaction commits
+ *   }
+ * }
+ * ```
+ */
+export interface ShouldQueueAfterCommit extends ShouldQueue {
+}
+//# sourceMappingURL=ShouldQueueAfterCommit.d.ts.map

package/dist/Listeners/Contracts/ShouldQueueAfterCommit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShouldQueueAfterCommit.d.ts","sourceRoot":"","sources":["../../../src/Listeners/Contracts/ShouldQueueAfterCommit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,sBAAuB,SAAQ,WAAW;CAE1D"}

package/dist/Listeners/Contracts/ShouldQueueAfterCommit.js

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

package/dist/Listeners/Contracts/ShouldQueueAfterCommit.js.map

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