@orchestr-sh/orchestr 1.6.0 → 1.7.0

package/README.md

@@ -9,6 +9,37 @@ npm install @orchestr-sh/orchestr reflect-metadata drizzle-orm
 npm install better-sqlite3 # or your preferred database driver
 ```
 
+### CLI Setup
+
+After installation, the `orchestr` command will be available in your project via `npx`:
+
+```bash
+# Run orchestr commands
+npx orchestr make:event UserRegistered
+npx orchestr make:migration create_users_table
+npx orchestr migrate
+
+# Or add to package.json scripts for convenience
+{
+  "scripts": {
+    "orchestr": "orchestr"
+  }
+}
+
+# Then run with npm
+npm run orchestr make:event UserRegistered
+```
+
+For global installation (optional):
+
+```bash
+npm install -g @orchestr-sh/orchestr
+
+# Now use orchestr directly
+orchestr make:event UserRegistered
+orchestr migrate
+```
+
 ## Quick Start
 
 ```typescript
@@ -224,25 +255,25 @@ Laravel-style migrations with a fluent Schema builder.
 
 ```bash
 # Create a migration
-orchestr make:migration create_users_table --create=users
+npx orchestr make:migration create_users_table --create=users
 
 # Run migrations
-orchestr migrate
+npx orchestr migrate
 
 # Rollback last batch
-orchestr migrate:rollback
+npx orchestr migrate:rollback
 
 # Rollback all migrations
-orchestr migrate:reset
+npx orchestr migrate:reset
 
 # Drop all tables and re-run migrations
-orchestr migrate:fresh
+npx orchestr migrate:fresh
 
 # Rollback and re-run all migrations
-orchestr migrate:refresh
+npx orchestr migrate:refresh
 
 # Check migration status
-orchestr migrate:status
+npx orchestr migrate:status
 ```
 
 ### Creating Tables
@@ -310,13 +341,13 @@ Populate your database with test or initial data.
 
 ```bash
 # Create a seeder
-orchestr make:seeder UserSeeder
+npx orchestr make:seeder UserSeeder
 
 # Run all seeders (runs DatabaseSeeder)
-orchestr db:seed
+npx orchestr db:seed
 
 # Run a specific seeder
-orchestr db:seed --class=UserSeeder
+npx orchestr db:seed --class=UserSeeder
 ```
 
 ### Creating Seeders
@@ -352,6 +383,227 @@ export default class DatabaseSeeder extends Seeder {
 }
 ```
 
+## Events and Listeners
+
+Laravel-style event system with listeners, subscribers, and automatic discovery.
+
+### Creating Events
+
+Events are simple classes that hold data about something that happened in your application.
+
+```typescript
+import { Event } from '@orchestr-sh/orchestr';
+
+export class UserRegistered extends Event {
+  constructor(public readonly user: User) {
+    super();
+  }
+}
+
+// Create via command
+npx orchestr make:event UserRegistered
+```
+
+### Creating Listeners
+
+Listeners handle events with a `handle` method.
+
+```typescript
+export class SendWelcomeEmail {
+  handle(event: UserRegistered): void {
+    // Send welcome email to event.user
+  }
+}
+
+// Create via command
+npx orchestr make:listener SendWelcomeEmail --event=UserRegistered
+npx orchestr make:listener ProcessOrder --queued  // For queued listeners
+```
+
+### Registering Events and Listeners
+
+Register in your `EventServiceProvider`:
+
+```typescript
+import { EventServiceProvider } from '@orchestr-sh/orchestr';
+
+export class AppEventServiceProvider extends EventServiceProvider {
+  protected listen = {
+    'UserRegistered': [
+      'SendWelcomeEmail',
+      'CreateUserProfile',
+    ],
+    'OrderPlaced': 'SendOrderConfirmation',
+  };
+}
+```
+
+Or use the Event facade to register listeners dynamically:
+
+```typescript
+import { Event } from '@orchestr-sh/orchestr';
+
+// Class-based listener
+Event.listen(UserRegistered, SendWelcomeEmail);
+
+// Closure listener
+Event.listen(UserRegistered, (event) => {
+  console.log(`User registered: ${event.user.email}`);
+});
+
+// Multiple events
+Event.listen(['UserRegistered', 'UserUpdated'], LogUserActivity);
+
+// Wildcard listeners
+Event.listen('user.*', (event) => {
+  // Handles user.registered, user.updated, etc.
+});
+```
+
+### Dispatching Events
+
+```typescript
+import { Event } from '@orchestr-sh/orchestr';
+
+// Dispatch via facade
+Event.dispatch(new UserRegistered(user));
+
+// Static dispatch on event class
+UserRegistered.dispatch(user);
+
+// Conditional dispatch
+UserRegistered.dispatchIf(user.isActive, user);
+UserRegistered.dispatchUnless(user.isAdmin, user);
+
+// Dispatch until first non-null response (halting)
+const result = UserRegistered.until(user);
+if (result === false) {
+  // Listener vetoed the operation
+}
+
+// Queue events for later
+Event.push('user.registered', [user]);
+Event.flush('user.registered'); // Dispatch all queued
+```
+
+### Event Subscribers
+
+Subscribers listen to multiple events in a single class:
+
+```typescript
+import { EventSubscriber, Dispatcher } from '@orchestr-sh/orchestr';
+
+export class UserEventSubscriber implements EventSubscriber {
+  subscribe(events: Dispatcher): void {
+    events.listen('UserRegistered', this.onRegistered.bind(this));
+    events.listen('UserUpdated', this.onUpdated.bind(this));
+    events.listen('user.*', this.logActivity.bind(this));
+  }
+
+  onRegistered(event: UserRegistered): void {
+    // Handle registration
+  }
+
+  onUpdated(event: UserUpdated): void {
+    // Handle update
+  }
+
+  logActivity(event: any): void {
+    // Log any user activity
+  }
+}
+
+// Register in EventServiceProvider
+protected subscribe = [
+  'UserEventSubscriber',
+];
+```
+
+### Model Events
+
+Ensemble models automatically dispatch lifecycle events:
+
+```typescript
+import { Event, ModelCreated, ModelUpdated, ModelDeleting } from '@orchestr-sh/orchestr';
+
+// Listen to model events
+Event.listen(ModelCreated, (event) => {
+  console.log('Model created:', event.model);
+});
+
+Event.listen(ModelDeleting, (event) => {
+  // Prevent deletion by returning false
+  if (event.model.isProtected) {
+    return false;
+  }
+});
+
+// Listen to specific model events using wildcards
+Event.listen('User.*', (event) => {
+  // Handles all User model events
+});
+```
+
+Available model events:
+- `ModelRetrieved` - After a model is retrieved from database
+- `ModelCreating` - Before a model is created (can halt)
+- `ModelCreated` - After a model is created
+- `ModelUpdating` - Before a model is updated (can halt)
+- `ModelUpdated` - After a model is updated
+- `ModelSaving` - Before a model is saved (can halt)
+- `ModelSaved` - After a model is saved
+- `ModelDeleting` - Before a model is deleted (can halt)
+- `ModelDeleted` - After a model is deleted
+
+### Testing Events
+
+Use `Event.fake()` to test event dispatching:
+
+```typescript
+import { Event } from '@orchestr-sh/orchestr';
+
+// Fake all events
+Event.fake();
+
+// Your code that dispatches events
+await userService.register(userData);
+
+// Assert events were dispatched
+Event.assertDispatched(UserRegistered);
+Event.assertDispatched(UserRegistered, (event) => {
+  return event.user.email === 'test@example.com';
+});
+Event.assertDispatchedTimes(UserRegistered, 2);
+Event.assertNotDispatched(UserDeleted);
+Event.assertNothingDispatched();
+
+// Fake specific events only
+Event.fake([UserRegistered, OrderPlaced]);
+
+// Fake all except specific events
+Event.fakeExcept([UserDeleted]);
+
+// Scoped faking
+const [result, fake] = await Event.fakeFor(async (fake) => {
+  await someService.createUser();
+  return 'done';
+});
+fake.assertDispatched(UserRegistered);
+```
+
+### Console Commands
+
+```bash
+# Create event
+orchestr make:event UserRegistered
+orchestr make:event OrderPlaced
+
+# Create listener
+orchestr make:listener SendWelcomeEmail
+orchestr make:listener SendWelcomeEmail --event=UserRegistered
+orchestr make:listener ProcessOrder --queued
+```
+
 ## Controllers
 
 ```typescript
@@ -579,22 +831,33 @@ table.softDeletes(column)           // deleted_at timestamp
 
 ### CLI Commands
 
+All commands should be run with `npx orchestr` (or just `orchestr` if installed globally):
+
 ```bash
 # Migrations
-orchestr make:migration <name>          # Create migration
-orchestr make:migration <name> --create=<table>  # Create table migration
-orchestr make:migration <name> --table=<table>   # Update table migration
-orchestr migrate                        # Run migrations
-orchestr migrate:rollback               # Rollback last batch
-orchestr migrate:reset                  # Rollback all migrations
-orchestr migrate:refresh                # Reset and re-run migrations
-orchestr migrate:fresh                  # Drop all tables and migrate
-orchestr migrate:status                 # Show migration status
+npx orchestr make:migration <name>          # Create migration
+npx orchestr make:migration <name> --create=<table>  # Create table migration
+npx orchestr make:migration <name> --table=<table>   # Update table migration
+npx orchestr migrate                        # Run migrations
+npx orchestr migrate:rollback               # Rollback last batch
+npx orchestr migrate:reset                  # Rollback all migrations
+npx orchestr migrate:refresh                # Reset and re-run migrations
+npx orchestr migrate:fresh                  # Drop all tables and migrate
+npx orchestr migrate:status                 # Show migration status
 
 # Seeders
-orchestr make:seeder <name>             # Create seeder
-orchestr db:seed                        # Run DatabaseSeeder
-orchestr db:seed --class=<name>         # Run specific seeder
+npx orchestr make:seeder <name>             # Create seeder
+npx orchestr db:seed                        # Run DatabaseSeeder
+npx orchestr db:seed --class=<name>         # Run specific seeder
+
+# Events & Listeners
+npx orchestr make:event <name>              # Create event
+npx orchestr make:listener <name>           # Create listener
+npx orchestr make:listener <name> --event=<EventName>  # Create listener for event
+npx orchestr make:listener <name> --queued  # Create queued listener
+npx orchestr event:list                     # List all registered events
+npx orchestr event:cache                    # Cache discovered events
+npx orchestr event:clear                    # Clear event cache
 ```
 
 ## Features
@@ -610,6 +873,10 @@ orchestr db:seed --class=<name>         # Run specific seeder
 - ✅ Eager/Lazy Loading
 - ✅ Migrations with Schema Builder
 - ✅ Database Seeders
+- ✅ Events & Listeners
+- ✅ Event Subscribers
+- ✅ Model Lifecycle Events
+- ✅ Event Testing (Fakes & Assertions)
 - ✅ Soft Deletes
 - ✅ Attribute Casting
 - ✅ Timestamps

package/dist/Console/Commands/EventCacheCommand.d.ts

@@ -0,0 +1,15 @@
+/**
+ * EventCacheCommand
+ *
+ * Discover and cache the application's events and listeners following Laravel's Artisan pattern
+ */
+import { Command } from '../Command';
+import { Application } from '../../Foundation/Application';
+export declare class EventCacheCommand extends Command {
+    protected app: Application;
+    signature: string;
+    description: string;
+    constructor(app: Application);
+    handle(): Promise<void>;
+}
+//# sourceMappingURL=EventCacheCommand.d.ts.map

package/dist/Console/Commands/EventCacheCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventCacheCommand.d.ts","sourceRoot":"","sources":["../../../src/Console/Commands/EventCacheCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAI3D,qBAAa,iBAAkB,SAAQ,OAAO;IAIhC,SAAS,CAAC,GAAG,EAAE,WAAW;IAHtC,SAAS,SAAiB;IAC1B,WAAW,SAAgE;gBAErD,GAAG,EAAE,WAAW;IAIhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAwD9B"}

package/dist/Console/Commands/EventCacheCommand.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * EventCacheCommand
+ *
+ * Discover and cache the application's events and listeners following Laravel's Artisan pattern
+ */
+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.EventCacheCommand = void 0;
+const Command_1 = require("../Command");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+class EventCacheCommand extends Command_1.Command {
+    app;
+    signature = 'event:cache';
+    description = 'Discover and cache the application\'s events and listeners';
+    constructor(app) {
+        super();
+        this.app = app;
+    }
+    async handle() {
+        this.info('Discovering events and listeners...');
+        try {
+            // Try to dynamically import EventDiscovery (Task 6 dependency)
+            const { EventDiscovery } = await Promise.resolve().then(() => __importStar(require('../../Support/EventDiscovery')));
+            const discovery = new EventDiscovery(this.app);
+            const directories = this.app.getEventDiscoveryPaths();
+            this.comment(`Scanning directories:`);
+            directories.forEach(dir => this.comment(`  - ${dir}`));
+            this.newLine();
+            const listeners = await discovery.discover(directories);
+            if (listeners.size === 0) {
+                this.warn('No events discovered.');
+                return;
+            }
+            // Convert Map to array for JSON serialization
+            const listenersArray = Array.from(listeners.entries());
+            // Create cache directory
+            const cachePath = this.app.storagePath('framework/events.json');
+            await fs.mkdir(path.dirname(cachePath), { recursive: true });
+            // Write cache file
+            await fs.writeFile(cachePath, JSON.stringify(listenersArray, null, 2));
+            this.info(`Events cached successfully!`);
+            this.newLine();
+            this.comment(`Cached ${listeners.size} events to: ${cachePath}`);
+            // Show summary
+            let totalListeners = 0;
+            for (const [, listenerList] of listeners) {
+                totalListeners += listenerList.length;
+            }
+            this.comment(`Total listeners: ${totalListeners}`);
+        }
+        catch (error) {
+            if (error.code === 'MODULE_NOT_FOUND' && error.message?.includes('EventDiscovery')) {
+                this.error('EventDiscovery module not found.');
+                this.comment('The EventDiscovery system (Task 6) must be implemented first.');
+                this.comment('This command will work once EventDiscovery is available.');
+            }
+            else {
+                this.error(`Failed to cache events: ${error.message}`);
+                throw error;
+            }
+        }
+    }
+}
+exports.EventCacheCommand = EventCacheCommand;
+//# sourceMappingURL=EventCacheCommand.js.map

package/dist/Console/Commands/EventCacheCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventCacheCommand.js","sourceRoot":"","sources":["../../../src/Console/Commands/EventCacheCommand.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,wCAAqC;AAErC,gDAAkC;AAClC,2CAA6B;AAE7B,MAAa,iBAAkB,SAAQ,iBAAO;IAItB;IAHtB,SAAS,GAAG,aAAa,CAAC;IAC1B,WAAW,GAAG,4DAA4D,CAAC;IAE3E,YAAsB,GAAgB;QACpC,KAAK,EAAE,CAAC;QADY,QAAG,GAAH,GAAG,CAAa;IAEtC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAEjD,IAAI,CAAC;YACH,+DAA+D;YAC/D,MAAM,EAAE,cAAc,EAAE,GAAG,wDAAa,8BAA8B,GAAC,CAAC;YAExE,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;YAEtD,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;YACtC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YAEf,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAExD,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;gBACnC,OAAO;YACT,CAAC;YAED,8CAA8C;YAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;YAEvD,yBAAyB;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;YAChE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7D,mBAAmB;YACnB,MAAM,EAAE,CAAC,SAAS,CAChB,SAAS,EACT,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CACxC,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,UAAU,SAAS,CAAC,IAAI,eAAe,SAAS,EAAE,CAAC,CAAC;YAEjE,eAAe;YACf,IAAI,cAAc,GAAG,CAAC,CAAC;YACvB,KAAK,MAAM,CAAC,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;gBACzC,cAAc,IAAI,YAAY,CAAC,MAAM,CAAC;YACxC,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,oBAAoB,cAAc,EAAE,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACnF,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC;gBAC9E,IAAI,CAAC,OAAO,CAAC,0DAA0D,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAhED,8CAgEC"}

package/dist/Console/Commands/EventClearCommand.d.ts

@@ -0,0 +1,15 @@
+/**
+ * EventClearCommand
+ *
+ * Clear all cached events and listeners following Laravel's Artisan pattern
+ */
+import { Command } from '../Command';
+import { Application } from '../../Foundation/Application';
+export declare class EventClearCommand extends Command {
+    protected app: Application;
+    signature: string;
+    description: string;
+    constructor(app: Application);
+    handle(): Promise<void>;
+}
+//# sourceMappingURL=EventClearCommand.d.ts.map

package/dist/Console/Commands/EventClearCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventClearCommand.d.ts","sourceRoot":"","sources":["../../../src/Console/Commands/EventClearCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAG3D,qBAAa,iBAAkB,SAAQ,OAAO;IAIhC,SAAS,CAAC,GAAG,EAAE,WAAW;IAHtC,SAAS,SAAiB;IAC1B,WAAW,SAA2C;gBAEhC,GAAG,EAAE,WAAW;IAIhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAgB9B"}

package/dist/Console/Commands/EventClearCommand.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * EventClearCommand
+ *
+ * Clear all cached events and listeners following Laravel's Artisan pattern
+ */
+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.EventClearCommand = void 0;
+const Command_1 = require("../Command");
+const fs = __importStar(require("fs/promises"));
+class EventClearCommand extends Command_1.Command {
+    app;
+    signature = 'event:clear';
+    description = 'Clear all cached events and listeners';
+    constructor(app) {
+        super();
+        this.app = app;
+    }
+    async handle() {
+        const cachePath = this.app.storagePath('framework/events.json');
+        try {
+            await fs.access(cachePath);
+            await fs.unlink(cachePath);
+            this.info('Cached events cleared successfully.');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                this.comment('No cached events found.');
+            }
+            else {
+                this.error(`Failed to clear cached events: ${error.message}`);
+                throw error;
+            }
+        }
+    }
+}
+exports.EventClearCommand = EventClearCommand;
+//# sourceMappingURL=EventClearCommand.js.map

package/dist/Console/Commands/EventClearCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventClearCommand.js","sourceRoot":"","sources":["../../../src/Console/Commands/EventClearCommand.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,wCAAqC;AAErC,gDAAkC;AAElC,MAAa,iBAAkB,SAAQ,iBAAO;IAItB;IAHtB,SAAS,GAAG,aAAa,CAAC;IAC1B,WAAW,GAAG,uCAAuC,CAAC;IAEtD,YAAsB,GAAgB;QACpC,KAAK,EAAE,CAAC;QADY,QAAG,GAAH,GAAG,CAAa;IAEtC,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,kCAAkC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9D,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAxBD,8CAwBC"}

package/dist/Console/Commands/EventListCommand.d.ts

@@ -0,0 +1,19 @@
+/**
+ * EventListCommand
+ *
+ * List all registered events and their listeners following Laravel's Artisan pattern
+ */
+import { Command, CommandOptions } from '../Command';
+import { Application } from '../../Foundation/Application';
+export declare class EventListCommand extends Command {
+    protected app: Application;
+    signature: string;
+    description: string;
+    constructor(app: Application);
+    handle(args: string[], options: CommandOptions): Promise<void>;
+    /**
+     * Format a listener for display
+     */
+    protected formatListener(listener: any): string;
+}
+//# sourceMappingURL=EventListCommand.d.ts.map

package/dist/Console/Commands/EventListCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventListCommand.d.ts","sourceRoot":"","sources":["../../../src/Console/Commands/EventListCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,qBAAa,gBAAiB,SAAQ,OAAO;IAI/B,SAAS,CAAC,GAAG,EAAE,WAAW;IAHtC,SAAS,SAA2B;IACpC,WAAW,SAAkD;gBAEvC,GAAG,EAAE,WAAW;IAIhC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA2FpE;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM;CAehD"}