@orchestr-sh/orchestr 1.11.0 → 1.11.1

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+## [1.11.1](https://github.com/orchestr-sh/orchestr/compare/v1.11.0...v1.11.1) (2026-04-07)
+
+
+### Bug Fixes
+
+* commit message for release ([#24](https://github.com/orchestr-sh/orchestr/issues/24)) ([accef91](https://github.com/orchestr-sh/orchestr/commit/accef91c66616ebf9e83874b00bb59e46f8fc6ac))
+
+# [1.11.0](https://github.com/orchestr-sh/orchestr/compare/v1.10.0...v1.11.0) (2026-04-07)
+
+
+### Bug Fixes
+
+* release workflow ([#21](https://github.com/orchestr-sh/orchestr/issues/21)) ([9bad22d](https://github.com/orchestr-sh/orchestr/commit/9bad22d8dd96407f24d80e16695d7162c0497425))
+
+
+### Features
+
+* tsdown, typescript 6 ([#17](https://github.com/orchestr-sh/orchestr/issues/17)) ([54581fe](https://github.com/orchestr-sh/orchestr/commit/54581fe8bd6c47d385fa7f61e59fde73fa0a030f))

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,43 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to providing a welcoming and inspiring community for all. We pledge to make participation in our community a harassment-free experience regardless of age, body size, caste, disability, ethnicity, gender identity and expression, level of experience, family status, gender, marital status, military or veteran status, national origin, personal appearance, race, religion, sex, sexual orientation, socioeconomic status, or any other dimension of diversity.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+
+- Using welcoming and inclusive language
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+- Demonstrating patience and understanding
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery and unwelcome sexual attention or advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+- Violence, threats of violence, or violent language directed against another person
+- Deliberate intimidation or stalking
+- Advocating for, or encouraging, any of the above behaviors
+
+## Enforcement
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+### Reporting Violations
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement. All complaints will be reviewed and investigated promptly and fairly.
+
+If you witness or experience unacceptable behavior, please report it by opening an issue or contacting the maintainers directly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

package/CONTRIBUTING.md

@@ -0,0 +1,274 @@
+# Contributing to Orchestr
+
+Thank you for your interest in contributing to Orchestr! We welcome contributions from the community. This document provides guidelines and instructions for contributing.
+
+## Code of Conduct
+
+Be respectful, inclusive, and constructive in all interactions with other contributors and maintainers.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js >= 22.0.0
+- npm or preferred package manager
+- TypeScript knowledge
+
+### Setup Development Environment
+
+1. Fork the repository on GitHub
+2. Clone your fork locally:
+   ```bash
+   git clone https://github.com/your-username/orchestr.git
+   cd orchestr
+   ```
+3. Add upstream remote:
+   ```bash
+   git remote add upstream https://github.com/orchestr-sh/orchestr.git
+   ```
+4. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+## Development Workflow
+
+### Building
+
+Build the TypeScript code:
+```bash
+npm run build
+```
+
+### Testing
+
+Run the test suite:
+```bash
+npm test          # Run tests once
+npm run test:watch  # Watch mode
+npm run test:coverage  # With coverage report
+```
+
+### Linting & Formatting
+
+The project uses **oxlint** and **Prettier** for code quality. Run before committing:
+```bash
+npm run lint      # Lint and auto-fix
+npm run format    # Format code
+```
+
+Validate without changes:
+```bash
+npm run test:lint  # Check linting
+npm run format:check  # Check formatting
+```
+
+### Type Checking
+
+Verify TypeScript types:
+```bash
+npm run test:types
+```
+
+## Making Changes
+
+### Create a Branch
+
+Create a feature or fix branch from `main`:
+```bash
+git checkout -b feature/your-feature-name
+# or
+git checkout -b fix/your-bug-fix
+```
+
+Use descriptive branch names (e.g., `feature/queue-batching`, `fix/cache-expiry`).
+
+### Write Code
+
+- Follow the existing code style and patterns
+- Use TypeScript with proper type annotations
+- Keep changes focused and atomic
+- Add tests for new functionality
+- Update documentation if needed
+
+### Commit Guidelines
+
+Write clear, concise commit messages:
+
+- Use present tense: "Add feature" not "Added feature"
+- Be descriptive: "feat: add job batching to queue system" not "update"
+- Be in the format `<type>[scope?][!]: Add job batching to queue system`
+- Start with a conventional commit type from the allowed type list
+- Breaking changes should include `!` after the allowed commit type e.g. `fix!:`
+
+Example:
+```
+feat: add queue job batching
+
+- Implement PendingBatch class for grouped job execution
+- Add batch callback support (then/catch/finally)
+- Include integration tests for batch workflows
+```
+
+#### Revert
+
+If the commit reverts a previous commit, it should begin with `revert: `, followed by the header of the reverted commit. In the body it should say: `This reverts commit <hash>.`, where the hash is the SHA of the commit being reverted.
+
+#### Type
+
+The type must be one of the following:
+
+| Type         | Description                                                                                                 |
+| ------------ | ----------------------------------------------------------------------------------------------------------- |
+| **build**    | Changes that affect the build system or external dependencies (example scopes: gulp, broccoli, npm)         |
+| **chore**    | Routine maintenance tasks that do not directly impact the functionality of the application                  |
+| **ci**       | Changes to our CI configuration files and scripts (example scopes: Travis, Circle, BrowserStack, SauceLabs) |
+| **docs**     | Documentation only changes                                                                                  |
+| **feat**     | A new feature                                                                                               |
+| **fix**      | A bug fix                                                                                                   |
+| **perf**     | A code change that improves performance                                                                     |
+| **refactor** | A code change that neither fixes a bug nor adds a feature                                                   |
+| **style**    | Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)      |
+| **test**     | Adding missing tests or correcting existing tests                                                           |
+
+### Git Hooks
+This project uses **husky** to automatically perform tasks during the git hook events.
+
+#### Pre-commit
+- **lint-staged** to automatically lint and format staged files. Ensure your code passes these checks before committing.
+
+#### Commit-msg
+- **commitlint** to automatically check your commit messages follow our CONTRIBUTING guidelines around conventional commits.
+
+## Testing
+
+### Writing Tests
+
+- Place tests in the tests directory
+- Use descriptive test names
+- Test both success and failure paths
+- Keep tests focused and independent
+
+Example structure:
+```typescript
+import { describe, it, expect, beforeEach } from 'vitest';
+
+describe('MyFeature', () => {
+  beforeEach(() => {
+    // Setup
+  });
+
+  it('should do something', () => {
+    // Test code
+    expect(result).toBe(expected);
+  });
+
+  it('should handle error cases', () => {
+    // Error test
+    expect(() => {
+      // code that throws
+    }).toThrow();
+  });
+});
+```
+
+## Pull Request Process
+
+1. **Update your branch** with latest upstream changes:
+   ```bash
+   git fetch upstream
+   git rebase upstream/main
+   ```
+
+2. **Push to your fork**:
+   ```bash
+   git push origin your-branch-name
+   ```
+
+3. **Create a Pull Request** on GitHub with:
+   - Clear title describing the change
+   - Description explaining what and why
+   - Reference any related issues (#123)
+   - Screenshots or examples if applicable
+
+4. **PR Description Template**:
+   ```
+   ## Description
+   Brief description of changes.
+
+   ## Related Issues
+   Closes #123
+
+   ## Type of Change
+   - [ ] Bug fix (non-breaking)
+   - [ ] New feature (non-breaking)
+   - [ ] Breaking change
+   - [ ] Documentation update
+
+   ## Testing
+   - [ ] Tests pass locally
+   - [ ] Added/updated tests
+   - [ ] Linting passes
+
+   ## Checklist
+   - [ ] Code follows style guidelines
+   - [ ] Comments added for complex logic
+   - [ ] Documentation updated
+   - [ ] No new warnings generated
+   ```
+
+5. **Review Process**:
+   - Address feedback promptly
+   - Request re-review after making changes
+   - Discuss disagreements respectfully
+   - All checks must pass (tests, linting, type checking)
+
+## Architecture & Patterns
+
+Orchestr follows Laravel's architecture patterns. Familiarize yourself with:
+
+- **Service Providers**: Extend `ServiceProvider`, implement `register()` and `boot()`
+- **Managers**: Connection managers using the manager pattern (DatabaseManager, QueueManager, CacheManager)
+- **Facades**: Static interfaces via `Facade` base class using Proxy forwarding
+- **Commands**: Extend `Command` with `signature`, `description`, `handle()`
+- **Events**: System event dispatcher with listeners and subscribers
+
+See README.md and docs/ for detailed patterns.
+
+## Documentation
+
+- Update README.md for user-facing changes
+- Add inline comments for complex logic
+- Document public APIs with JSDoc
+- Update docs/ folder if adding major features
+
+## Reporting Issues
+
+### Bug Reports
+
+Include:
+- Node.js and npm versions
+- Orchestr version
+- Minimal reproduction code
+- Expected vs actual behavior
+- Relevant error messages
+
+### Feature Requests
+
+Include:
+- Clear use case and motivation
+- Proposed API/interface
+- Examples of how it would be used
+- Any alternatives considered
+
+## Questions?
+
+- Check existing issues and discussions
+- Ask in pull request comments
+- Open a GitHub discussion for questions
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+Thank you for helping make Orchestr better! 🎉

package/dist/Console/orchestr.cjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`../Foundation/Application.cjs`),t=require(`./ConsoleKernel.cjs`),n=require(`./Commands/MigrateCommand.cjs`),r=require(`./Commands/MigrateRollbackCommand.cjs`),i=require(`./Commands/MigrateResetCommand.cjs`),a=require(`./Commands/MigrateRefreshCommand.cjs`),o=require(`./Commands/MigrateFreshCommand.cjs`),s=require(`./Commands/MigrateStatusCommand.cjs`),c=require(`./Commands/MakeMigrationCommand.cjs`),l=require(`./Commands/SeedCommand.cjs`),u=require(`./Commands/MakeSeederCommand.cjs`),d=require(`./Commands/MakeEventCommand.cjs`),f=require(`./Commands/MakeListenerCommand.cjs`),p=require(`./Commands/MakeControllerCommand.cjs`),m=require(`./Commands/EventListCommand.cjs`),h=require(`./Commands/EventCacheCommand.cjs`),g=require(`./Commands/EventClearCommand.cjs`),_=require(`./Commands/DeployLoginCommand.cjs`),v=require(`./Commands/DeployInitCommand.cjs`),y=require(`./Commands/DeployServerCommand.cjs`),b=require(`./Commands/DeployCommand.cjs`),x=require(`./Commands/DeployStatusCommand.cjs`),S=require(`./Commands/DeployEnvCommand.cjs`),C=require(`./Commands/DeployRollbackCommand.cjs`),w=require(`./Commands/DeployProvisionCommand.cjs`),T=new e.Application;new class extends t.ConsoleKernel{registerCommands(){this.registerMany([new n.MigrateCommand(this.app),new r.MigrateRollbackCommand(this.app),new i.MigrateResetCommand(this.app),new a.MigrateRefreshCommand(this.app),new o.MigrateFreshCommand(this.app),new s.MigrateStatusCommand(this.app),new c.MakeMigrationCommand(this.app),new l.SeedCommand(this.app),new u.MakeSeederCommand(this.app),new d.MakeEventCommand(this.app),new f.MakeListenerCommand(this.app),new p.MakeControllerCommand(this.app),new m.EventListCommand(this.app),new h.EventCacheCommand(this.app),new g.EventClearCommand(this.app),new _.DeployLoginCommand,new v.DeployInitCommand,new y.DeployServerCommand,new b.DeployCommand,new x.DeployStatusCommand,new S.DeployEnvCommand,new C.DeployRollbackCommand,new w.DeployProvisionCommand])}}(T).run().catch(e=>{console.error(e),process.exit(1)});

package/dist/Console/orchestr.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/Console/orchestr.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/Console/orchestr.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{Application as e}from"../Foundation/Application.mjs";import{ConsoleKernel as t}from"./ConsoleKernel.mjs";import{MigrateCommand as n}from"./Commands/MigrateCommand.mjs";import{MigrateRollbackCommand as r}from"./Commands/MigrateRollbackCommand.mjs";import{MigrateResetCommand as i}from"./Commands/MigrateResetCommand.mjs";import{MigrateRefreshCommand as a}from"./Commands/MigrateRefreshCommand.mjs";import{MigrateFreshCommand as o}from"./Commands/MigrateFreshCommand.mjs";import{MigrateStatusCommand as s}from"./Commands/MigrateStatusCommand.mjs";import{MakeMigrationCommand as c}from"./Commands/MakeMigrationCommand.mjs";import{SeedCommand as l}from"./Commands/SeedCommand.mjs";import{MakeSeederCommand as u}from"./Commands/MakeSeederCommand.mjs";import{MakeEventCommand as d}from"./Commands/MakeEventCommand.mjs";import{MakeListenerCommand as f}from"./Commands/MakeListenerCommand.mjs";import{MakeControllerCommand as p}from"./Commands/MakeControllerCommand.mjs";import{EventListCommand as m}from"./Commands/EventListCommand.mjs";import{EventCacheCommand as h}from"./Commands/EventCacheCommand.mjs";import{EventClearCommand as g}from"./Commands/EventClearCommand.mjs";import{DeployLoginCommand as _}from"./Commands/DeployLoginCommand.mjs";import{DeployInitCommand as v}from"./Commands/DeployInitCommand.mjs";import{DeployServerCommand as y}from"./Commands/DeployServerCommand.mjs";import{DeployCommand as b}from"./Commands/DeployCommand.mjs";import{DeployStatusCommand as x}from"./Commands/DeployStatusCommand.mjs";import{DeployEnvCommand as S}from"./Commands/DeployEnvCommand.mjs";import{DeployRollbackCommand as C}from"./Commands/DeployRollbackCommand.mjs";import{DeployProvisionCommand as w}from"./Commands/DeployProvisionCommand.mjs";const T=new e;new class extends t{registerCommands(){this.registerMany([new n(this.app),new r(this.app),new i(this.app),new a(this.app),new o(this.app),new s(this.app),new c(this.app),new l(this.app),new u(this.app),new d(this.app),new f(this.app),new p(this.app),new m(this.app),new h(this.app),new g(this.app),new _,new v,new y,new b,new x,new S,new C,new w])}}(T).run().catch(e=>{console.error(e),process.exit(1)});export{};
+//# sourceMappingURL=orchestr.mjs.map

package/dist/Console/orchestr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestr.mjs","names":[],"sources":["../../src/Console/orchestr.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Orchestr CLI\n *\n * Command-line interface for Orchestr\n */\n\nimport { Application } from '@/Foundation/Application';\nimport { DeployCommand } from './Commands/DeployCommand';\nimport { DeployEnvCommand } from './Commands/DeployEnvCommand';\nimport { DeployInitCommand } from './Commands/DeployInitCommand';\nimport { DeployLoginCommand } from './Commands/DeployLoginCommand';\nimport { DeployProvisionCommand } from './Commands/DeployProvisionCommand';\nimport { DeployRollbackCommand } from './Commands/DeployRollbackCommand';\nimport { DeployServerCommand } from './Commands/DeployServerCommand';\nimport { DeployStatusCommand } from './Commands/DeployStatusCommand';\nimport { EventCacheCommand } from './Commands/EventCacheCommand';\nimport { EventClearCommand } from './Commands/EventClearCommand';\nimport { EventListCommand } from './Commands/EventListCommand';\nimport { MakeControllerCommand } from './Commands/MakeControllerCommand';\nimport { MakeEventCommand } from './Commands/MakeEventCommand';\nimport { MakeListenerCommand } from './Commands/MakeListenerCommand';\nimport { MakeMigrationCommand } from './Commands/MakeMigrationCommand';\nimport { MakeSeederCommand } from './Commands/MakeSeederCommand';\nimport { MigrateCommand } from './Commands/MigrateCommand';\nimport { MigrateFreshCommand } from './Commands/MigrateFreshCommand';\nimport { MigrateRefreshCommand } from './Commands/MigrateRefreshCommand';\nimport { MigrateResetCommand } from './Commands/MigrateResetCommand';\nimport { MigrateRollbackCommand } from './Commands/MigrateRollbackCommand';\nimport { MigrateStatusCommand } from './Commands/MigrateStatusCommand';\nimport { SeedCommand } from './Commands/SeedCommand';\nimport { ConsoleKernel } from './ConsoleKernel';\n\n// Create application instance\nconst app = new Application();\n\n// Create console kernel\nclass OrchestrKernel extends ConsoleKernel {\n  protected registerCommands(): void {\n    // Register migration commands\n    this.registerMany([\n      new MigrateCommand(this.app),\n      new MigrateRollbackCommand(this.app),\n      new MigrateResetCommand(this.app),\n      new MigrateRefreshCommand(this.app),\n      new MigrateFreshCommand(this.app),\n      new MigrateStatusCommand(this.app),\n      new MakeMigrationCommand(this.app),\n      new SeedCommand(this.app),\n      new MakeSeederCommand(this.app),\n      new MakeEventCommand(this.app),\n      new MakeListenerCommand(this.app),\n      new MakeControllerCommand(this.app),\n      new EventListCommand(this.app),\n      new EventCacheCommand(this.app),\n      new EventClearCommand(this.app),\n      // Deploy commands\n      new DeployLoginCommand(),\n      new DeployInitCommand(),\n      new DeployServerCommand(),\n      new DeployCommand(),\n      new DeployStatusCommand(),\n      new DeployEnvCommand(),\n      new DeployRollbackCommand(),\n      new DeployProvisionCommand(),\n    ]);\n  }\n}\n\n// Run the CLI\nconst kernel = new OrchestrKernel(app);\nkernel.run().catch((error) => {\n  console.error(error);\n  process.exit(1);\n});\n"],"mappings":";itDAkCA,MAAM,EAAM,IAAI,EAoCD,IAjCf,cAA6B,CAAc,CACzC,kBAAmC,CAEjC,KAAK,aAAa,CAChB,IAAI,EAAe,KAAK,IAAI,CAC5B,IAAI,EAAuB,KAAK,IAAI,CACpC,IAAI,EAAoB,KAAK,IAAI,CACjC,IAAI,EAAsB,KAAK,IAAI,CACnC,IAAI,EAAoB,KAAK,IAAI,CACjC,IAAI,EAAqB,KAAK,IAAI,CAClC,IAAI,EAAqB,KAAK,IAAI,CAClC,IAAI,EAAY,KAAK,IAAI,CACzB,IAAI,EAAkB,KAAK,IAAI,CAC/B,IAAI,EAAiB,KAAK,IAAI,CAC9B,IAAI,EAAoB,KAAK,IAAI,CACjC,IAAI,EAAsB,KAAK,IAAI,CACnC,IAAI,EAAiB,KAAK,IAAI,CAC9B,IAAI,EAAkB,KAAK,IAAI,CAC/B,IAAI,EAAkB,KAAK,IAAI,CAE/B,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACL,CAAC,GAK4B,EAAI,CAC/B,KAAK,CAAC,MAAO,GAAU,CAC5B,QAAQ,MAAM,EAAM,CACpB,QAAQ,KAAK,EAAE,EACf"}

package/dist/Events/Dispatcher.d.cts

@@ -1,5 +1,5 @@
-import { Container } from "../Container/Container.cjs";
 import { Event } from "./Event.cjs";
+import { Container } from "../Container/Container.cjs";
 import { EventListener, EventSubscriber } from "./types.cjs";
 import { DispatcherContract } from "./Contracts/Dispatcher.cjs";
 

package/dist/Events/Dispatcher.d.mts

@@ -1,5 +1,5 @@
-import { Container } from "../Container/Container.mjs";
 import { Event } from "./Event.mjs";
+import { Container } from "../Container/Container.mjs";
 import { EventListener, EventSubscriber } from "./types.mjs";
 import { DispatcherContract } from "./Contracts/Dispatcher.mjs";
 

package/dist/Events/EventServiceProvider.d.cts

@@ -1,5 +1,5 @@
-import { ServiceProvider } from "../Foundation/ServiceProvider.cjs";
 import { Dispatcher } from "./Dispatcher.cjs";
+import { ServiceProvider } from "../Foundation/ServiceProvider.cjs";
 
 //#region src/Events/EventServiceProvider.d.ts
 /**

package/dist/Events/EventServiceProvider.d.mts

@@ -1,5 +1,5 @@
-import { ServiceProvider } from "../Foundation/ServiceProvider.mjs";
 import { Dispatcher } from "./Dispatcher.mjs";
+import { ServiceProvider } from "../Foundation/ServiceProvider.mjs";
 
 //#region src/Events/EventServiceProvider.d.ts
 /**

package/dist/Events/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`./Concerns/Dispatchable.cjs`),t=require(`./Event.cjs`),n=require(`./Dispatcher.cjs`),r=require(`./EventServiceProvider.cjs`);exports.Dispatchable=e.Dispatchable,exports.Dispatcher=n.Dispatcher,exports.Event=t.Event,exports.EventServiceProvider=r.EventServiceProvider,exports.applyDispatchable=e.applyDispatchable;

package/dist/Events/index.d.cts

@@ -0,0 +1,7 @@
+import { Event, EventClass } from "./Event.cjs";
+import { EventListener, EventPayload, EventSubscriber, ListenerClosure, ListenerInterface, QueuedListener } from "./types.cjs";
+import { DispatcherContract } from "./Contracts/Dispatcher.cjs";
+import { Dispatcher } from "./Dispatcher.cjs";
+import { EventServiceProvider } from "./EventServiceProvider.cjs";
+import { Dispatchable, applyDispatchable } from "./Concerns/Dispatchable.cjs";
+export { Dispatchable, Dispatcher, type DispatcherContract, Event, type EventClass, type EventListener, type EventPayload, EventServiceProvider, type EventSubscriber, type ListenerClosure, type ListenerInterface, type QueuedListener, applyDispatchable };

package/dist/Events/index.d.mts

@@ -0,0 +1,7 @@
+import { Event, EventClass } from "./Event.mjs";
+import { EventListener, EventPayload, EventSubscriber, ListenerClosure, ListenerInterface, QueuedListener } from "./types.mjs";
+import { DispatcherContract } from "./Contracts/Dispatcher.mjs";
+import { Dispatcher } from "./Dispatcher.mjs";
+import { EventServiceProvider } from "./EventServiceProvider.mjs";
+import { Dispatchable, applyDispatchable } from "./Concerns/Dispatchable.mjs";
+export { Dispatchable, Dispatcher, type DispatcherContract, Event, type EventClass, type EventListener, type EventPayload, EventServiceProvider, type EventSubscriber, type ListenerClosure, type ListenerInterface, type QueuedListener, applyDispatchable };

package/dist/Events/index.mjs

@@ -0,0 +1 @@
+import{Dispatchable as e,applyDispatchable as t}from"./Concerns/Dispatchable.mjs";import{Event as n}from"./Event.mjs";import{Dispatcher as r}from"./Dispatcher.mjs";import{EventServiceProvider as i}from"./EventServiceProvider.mjs";export{e as Dispatchable,r as Dispatcher,n as Event,i as EventServiceProvider,t as applyDispatchable};

package/dist/Facades/Event.d.cts

@@ -1,7 +1,7 @@
-import { Facade } from "../Support/Facade.cjs";
 import { Event as Event$1 } from "../Events/Event.cjs";
 import { EventListener } from "../Events/types.cjs";
 import { Dispatcher } from "../Events/Dispatcher.cjs";
+import { Facade } from "../Support/Facade.cjs";
 import { EventFake } from "../Support/Testing/Fakes/EventFake.cjs";
 
 //#region src/Facades/Event.d.ts

package/dist/Facades/Event.d.mts

@@ -1,7 +1,7 @@
-import { Facade } from "../Support/Facade.mjs";
 import { Event as Event$1 } from "../Events/Event.mjs";
 import { EventListener } from "../Events/types.mjs";
 import { Dispatcher } from "../Events/Dispatcher.mjs";
+import { Facade } from "../Support/Facade.mjs";
 import { EventFake } from "../Support/Testing/Fakes/EventFake.mjs";
 
 //#region src/Facades/Event.d.ts

package/dist/Facades/Route.d.cts

@@ -1,5 +1,5 @@
-import { Router } from "../Routing/Router.cjs";
 import { Facade } from "../Support/Facade.cjs";
+import { Router } from "../Routing/Router.cjs";
 
 //#region src/Facades/Route.d.ts
 /**

package/dist/Facades/Route.d.mts

@@ -1,5 +1,5 @@
-import { Router } from "../Routing/Router.mjs";
 import { Facade } from "../Support/Facade.mjs";
+import { Router } from "../Routing/Router.mjs";
 
 //#region src/Facades/Route.d.ts
 /**

package/dist/Facades/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../_virtual/_rolldown/runtime.cjs`);const e=require(`./Route.cjs`),t=require(`./Config.cjs`),n=require(`../Support/Testing/Fakes/EventFake.cjs`),r=require(`./Event.cjs`),i=require(`./Queue.cjs`),a=require(`./Bus.cjs`),o=require(`./Cache.cjs`),s=require(`./DB.cjs`);exports.Bus=a.Bus,exports.Cache=o.Cache,exports.Config=t.Config,exports.DB=s.DB,exports.Event=r.Event,exports.EventFake=n.EventFake,exports.Queue=i.Queue,exports.Route=e.Route;

package/dist/Facades/index.d.cts

@@ -0,0 +1,9 @@
+import { Config } from "./Config.cjs";
+import { DB } from "./DB.cjs";
+import { Route } from "./Route.cjs";
+import { EventFake } from "../Support/Testing/Fakes/EventFake.cjs";
+import { Event } from "./Event.cjs";
+import { Queue } from "./Queue.cjs";
+import { Bus } from "./Bus.cjs";
+import { Cache } from "./Cache.cjs";
+export { Bus, Cache, Config, DB, Event, EventFake, Queue, Route };

package/dist/Facades/index.d.mts

@@ -0,0 +1,9 @@
+import { Config } from "./Config.mjs";
+import { DB } from "./DB.mjs";
+import { Route } from "./Route.mjs";
+import { EventFake } from "../Support/Testing/Fakes/EventFake.mjs";
+import { Event } from "./Event.mjs";
+import { Queue } from "./Queue.mjs";
+import { Bus } from "./Bus.mjs";
+import { Cache } from "./Cache.mjs";
+export { Bus, Cache, Config, DB, Event, EventFake, Queue, Route };

package/dist/Facades/index.mjs

@@ -0,0 +1 @@
+import{Route as e}from"./Route.mjs";import{Config as t}from"./Config.mjs";import{EventFake as n}from"../Support/Testing/Fakes/EventFake.mjs";import{Event as r}from"./Event.mjs";import{Queue as i}from"./Queue.mjs";import{Bus as a}from"./Bus.mjs";import{Cache as o}from"./Cache.mjs";import{DB as s}from"./DB.mjs";export{a as Bus,o as Cache,t as Config,s as DB,r as Event,n as EventFake,i as Queue,e as Route};

package/dist/Foundation/Config/ConfigServiceProvider.d.cts

@@ -1,5 +1,5 @@
-import { ServiceProvider } from "../ServiceProvider.cjs";
 import { Application } from "../Application.cjs";
+import { ServiceProvider } from "../ServiceProvider.cjs";
 
 //#region src/Foundation/Config/ConfigServiceProvider.d.ts
 /**

package/dist/Foundation/Config/ConfigServiceProvider.d.mts

@@ -1,5 +1,5 @@
-import { ServiceProvider } from "../ServiceProvider.mjs";
 import { Application } from "../Application.mjs";
+import { ServiceProvider } from "../ServiceProvider.mjs";
 
 //#region src/Foundation/Config/ConfigServiceProvider.d.ts
 /**

package/dist/Foundation/Http/FormRequest.d.cts

@@ -1,5 +1,5 @@
-import { Request } from "../../Routing/Request.cjs";
 import { Response } from "../../Routing/Response.cjs";
+import { Request } from "../../Routing/Request.cjs";
 import { ValidationRules, Validator } from "./Validator.cjs";
 import { ValidationException } from "./ValidationException.cjs";
 

package/dist/Foundation/Http/FormRequest.d.mts

@@ -1,5 +1,5 @@
-import { Request } from "../../Routing/Request.mjs";
 import { Response } from "../../Routing/Response.mjs";
+import { Request } from "../../Routing/Request.mjs";
 import { ValidationRules, Validator } from "./Validator.mjs";
 import { ValidationException } from "./ValidationException.mjs";
 

package/dist/Routing/Route.d.cts

@@ -1,5 +1,5 @@
-import { Request } from "./Request.cjs";
 import { Response } from "./Response.cjs";
+import { Request } from "./Request.cjs";
 
 //#region src/Routing/Route.d.ts
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';

package/dist/Routing/Route.d.mts

@@ -1,5 +1,5 @@
-import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
+import { Request } from "./Request.mjs";
 
 //#region src/Routing/Route.d.ts
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';

package/dist/Routing/Router.d.cts

@@ -1,7 +1,7 @@
 import { Application } from "../Foundation/Application.cjs";
-import { Request } from "./Request.cjs";
 import { Response } from "./Response.cjs";
 import { HttpMethod, Middleware, Route, RouteAction } from "./Route.cjs";
+import { Request } from "./Request.cjs";
 
 //#region src/Routing/Router.d.ts
 /**

package/dist/Routing/Router.d.mts

@@ -1,7 +1,7 @@
 import { Application } from "../Foundation/Application.mjs";
-import { Request } from "./Request.mjs";
 import { Response } from "./Response.mjs";
 import { HttpMethod, Middleware, Route, RouteAction } from "./Route.mjs";
+import { Request } from "./Request.mjs";
 
 //#region src/Routing/Router.d.ts
 /**

package/dist/Support/Testing/Fakes/EventFake.d.cts

@@ -1,5 +1,5 @@
-import { Container } from "../../../Container/Container.cjs";
 import { Event } from "../../../Events/Event.cjs";
+import { Container } from "../../../Container/Container.cjs";
 import { EventListener } from "../../../Events/types.cjs";
 import { DispatcherContract } from "../../../Events/Contracts/Dispatcher.cjs";
 

package/dist/Support/Testing/Fakes/EventFake.d.mts

@@ -1,5 +1,5 @@
-import { Container } from "../../../Container/Container.mjs";
 import { Event } from "../../../Events/Event.mjs";
+import { Container } from "../../../Container/Container.mjs";
 import { EventListener } from "../../../Events/types.mjs";
 import { DispatcherContract } from "../../../Events/Contracts/Dispatcher.mjs";
 

package/dist/index.d.cts

@@ -1,25 +1,21 @@
+import { Event, EventClass } from "./Events/Event.cjs";
 import { Abstract, Binding, Concrete, Container } from "./Container/Container.cjs";
-import { ServiceProvider } from "./Foundation/ServiceProvider.cjs";
+import { EventListener, EventPayload, EventSubscriber, ListenerClosure, ListenerInterface, QueuedListener } from "./Events/types.cjs";
+import { DispatcherContract } from "./Events/Contracts/Dispatcher.cjs";
+import { Dispatcher } from "./Events/Dispatcher.cjs";
 import { Application } from "./Foundation/Application.cjs";
-import { Request } from "./Routing/Request.cjs";
+import { ServiceProvider } from "./Foundation/ServiceProvider.cjs";
+import { EventServiceProvider } from "./Events/EventServiceProvider.cjs";
+import { Dispatchable, applyDispatchable } from "./Events/Concerns/Dispatchable.cjs";
+import { Config as Config$1 } from "./Foundation/Config/Config.cjs";
+import { Facade } from "./Support/Facade.cjs";
+import { Config } from "./Facades/Config.cjs";
+import { DB } from "./Facades/DB.cjs";
 import { CookieOptions, Response } from "./Routing/Response.cjs";
 import { HttpMethod, Middleware, Route as Route$1, RouteAction } from "./Routing/Route.cjs";
+import { Request } from "./Routing/Request.cjs";
 import { Router } from "./Routing/Router.cjs";
-import { Kernel } from "./Foundation/Http/Kernel.cjs";
-import { ValidationRule, ValidationRuleObject, ValidationRules, Validator } from "./Foundation/Http/Validator.cjs";
-import { ValidationException } from "./Foundation/Http/ValidationException.cjs";
-import { FormRequest } from "./Foundation/Http/FormRequest.cjs";
-import { Rule } from "./Foundation/Http/Rule.cjs";
-import { Config as Config$1 } from "./Foundation/Config/Config.cjs";
-import { ConfigServiceProvider } from "./Foundation/Config/ConfigServiceProvider.cjs";
-import { Controller } from "./Routing/Controller.cjs";
-import { Facade } from "./Support/Facade.cjs";
 import { Route } from "./Facades/Route.cjs";
-import { Config } from "./Facades/Config.cjs";
-import { Event, EventClass } from "./Events/Event.cjs";
-import { EventListener, EventPayload, EventSubscriber, ListenerClosure, ListenerInterface, QueuedListener } from "./Events/types.cjs";
-import { DispatcherContract } from "./Events/Contracts/Dispatcher.cjs";
-import { Dispatcher } from "./Events/Dispatcher.cjs";
 import { Event as Event$1 } from "./Facades/Event.cjs";
 import { PendingDispatch } from "./Queue/PendingDispatch.cjs";
 import { JobMiddleware } from "./Queue/Middleware/JobMiddleware.cjs";
@@ -40,6 +36,13 @@ import { TaggedCache } from "./Cache/Tags/TaggedCache.cjs";
 import { Repository } from "./Cache/Repository.cjs";
 import { CacheConfig, CacheManager, StoreConfig, StoreFactory } from "./Cache/CacheManager.cjs";
 import { Cache } from "./Facades/Cache.cjs";
+import { Kernel } from "./Foundation/Http/Kernel.cjs";
+import { ValidationRule, ValidationRuleObject, ValidationRules, Validator } from "./Foundation/Http/Validator.cjs";
+import { ValidationException } from "./Foundation/Http/ValidationException.cjs";
+import { FormRequest } from "./Foundation/Http/FormRequest.cjs";
+import { Rule } from "./Foundation/Http/Rule.cjs";
+import { ConfigServiceProvider } from "./Foundation/Config/ConfigServiceProvider.cjs";
+import { Controller } from "./Routing/Controller.cjs";
 import { ViewEngine } from "./View/Engines/ViewEngine.cjs";
 import { TemplateEngine, TemplateEngineResolver } from "./View/Engines/TemplateEngine.cjs";
 import { View } from "./View/View.cjs";
@@ -60,7 +63,6 @@ import { Connection } from "./Database/Connection.cjs";
 import { DatabaseConnectionConfig, DatabaseManager, DatabaseManagerConfig } from "./Database/DatabaseManager.cjs";
 import { Expression, raw } from "./Database/Query/Expression.cjs";
 import { DrizzleAdapter } from "./Database/Adapters/DrizzleAdapter.cjs";
-import { DB } from "./Facades/DB.cjs";
 import { EnsembleCollection } from "./Database/Ensemble/EnsembleCollection.cjs";
 import { Relation } from "./Database/Ensemble/Relations/Relation.cjs";
 import { HasOne } from "./Database/Ensemble/Relations/HasOne.cjs";
@@ -142,8 +144,6 @@ import { DeployEnvCommand } from "./Console/Commands/DeployEnvCommand.cjs";
 import { DeployRollbackCommand } from "./Console/Commands/DeployRollbackCommand.cjs";
 import { DeployProvisionCommand } from "./Console/Commands/DeployProvisionCommand.cjs";
 import { ProvisionOptions, Provisioner } from "./Deploy/Provisioner.cjs";
-import { EventServiceProvider } from "./Events/EventServiceProvider.cjs";
-import { Dispatchable, applyDispatchable } from "./Events/Concerns/Dispatchable.cjs";
 import { ModelEvent } from "./Database/Ensemble/Events/ModelEvent.cjs";
 import { ModelRetrieved } from "./Database/Ensemble/Events/ModelRetrieved.cjs";
 import { ModelCreating } from "./Database/Ensemble/Events/ModelCreating.cjs";

package/dist/index.d.mts

@@ -1,25 +1,21 @@
+import { Event, EventClass } from "./Events/Event.mjs";
 import { Abstract, Binding, Concrete, Container } from "./Container/Container.mjs";
-import { ServiceProvider } from "./Foundation/ServiceProvider.mjs";
+import { EventListener, EventPayload, EventSubscriber, ListenerClosure, ListenerInterface, QueuedListener } from "./Events/types.mjs";
+import { DispatcherContract } from "./Events/Contracts/Dispatcher.mjs";
+import { Dispatcher } from "./Events/Dispatcher.mjs";
 import { Application } from "./Foundation/Application.mjs";
-import { Request } from "./Routing/Request.mjs";
+import { ServiceProvider } from "./Foundation/ServiceProvider.mjs";
+import { EventServiceProvider } from "./Events/EventServiceProvider.mjs";
+import { Dispatchable, applyDispatchable } from "./Events/Concerns/Dispatchable.mjs";
+import { Config as Config$1 } from "./Foundation/Config/Config.mjs";
+import { Facade } from "./Support/Facade.mjs";
+import { Config } from "./Facades/Config.mjs";
+import { DB } from "./Facades/DB.mjs";
 import { CookieOptions, Response } from "./Routing/Response.mjs";
 import { HttpMethod, Middleware, Route as Route$1, RouteAction } from "./Routing/Route.mjs";
+import { Request } from "./Routing/Request.mjs";
 import { Router } from "./Routing/Router.mjs";
-import { Kernel } from "./Foundation/Http/Kernel.mjs";
-import { ValidationRule, ValidationRuleObject, ValidationRules, Validator } from "./Foundation/Http/Validator.mjs";
-import { ValidationException } from "./Foundation/Http/ValidationException.mjs";
-import { FormRequest } from "./Foundation/Http/FormRequest.mjs";
-import { Rule } from "./Foundation/Http/Rule.mjs";
-import { Config as Config$1 } from "./Foundation/Config/Config.mjs";
-import { ConfigServiceProvider } from "./Foundation/Config/ConfigServiceProvider.mjs";
-import { Controller } from "./Routing/Controller.mjs";
-import { Facade } from "./Support/Facade.mjs";
 import { Route } from "./Facades/Route.mjs";
-import { Config } from "./Facades/Config.mjs";
-import { Event, EventClass } from "./Events/Event.mjs";
-import { EventListener, EventPayload, EventSubscriber, ListenerClosure, ListenerInterface, QueuedListener } from "./Events/types.mjs";
-import { DispatcherContract } from "./Events/Contracts/Dispatcher.mjs";
-import { Dispatcher } from "./Events/Dispatcher.mjs";
 import { Event as Event$1 } from "./Facades/Event.mjs";
 import { PendingDispatch } from "./Queue/PendingDispatch.mjs";
 import { JobMiddleware } from "./Queue/Middleware/JobMiddleware.mjs";
@@ -40,6 +36,13 @@ import { TaggedCache } from "./Cache/Tags/TaggedCache.mjs";
 import { Repository } from "./Cache/Repository.mjs";
 import { CacheConfig, CacheManager, StoreConfig, StoreFactory } from "./Cache/CacheManager.mjs";
 import { Cache } from "./Facades/Cache.mjs";
+import { Kernel } from "./Foundation/Http/Kernel.mjs";
+import { ValidationRule, ValidationRuleObject, ValidationRules, Validator } from "./Foundation/Http/Validator.mjs";
+import { ValidationException } from "./Foundation/Http/ValidationException.mjs";
+import { FormRequest } from "./Foundation/Http/FormRequest.mjs";
+import { Rule } from "./Foundation/Http/Rule.mjs";
+import { ConfigServiceProvider } from "./Foundation/Config/ConfigServiceProvider.mjs";
+import { Controller } from "./Routing/Controller.mjs";
 import { ViewEngine } from "./View/Engines/ViewEngine.mjs";
 import { TemplateEngine, TemplateEngineResolver } from "./View/Engines/TemplateEngine.mjs";
 import { View } from "./View/View.mjs";
@@ -60,7 +63,6 @@ import { Connection } from "./Database/Connection.mjs";
 import { DatabaseConnectionConfig, DatabaseManager, DatabaseManagerConfig } from "./Database/DatabaseManager.mjs";
 import { Expression, raw } from "./Database/Query/Expression.mjs";
 import { DrizzleAdapter } from "./Database/Adapters/DrizzleAdapter.mjs";
-import { DB } from "./Facades/DB.mjs";
 import { EnsembleCollection } from "./Database/Ensemble/EnsembleCollection.mjs";
 import { Relation } from "./Database/Ensemble/Relations/Relation.mjs";
 import { HasOne } from "./Database/Ensemble/Relations/HasOne.mjs";
@@ -142,8 +144,6 @@ import { DeployEnvCommand } from "./Console/Commands/DeployEnvCommand.mjs";
 import { DeployRollbackCommand } from "./Console/Commands/DeployRollbackCommand.mjs";
 import { DeployProvisionCommand } from "./Console/Commands/DeployProvisionCommand.mjs";
 import { ProvisionOptions, Provisioner } from "./Deploy/Provisioner.mjs";
-import { EventServiceProvider } from "./Events/EventServiceProvider.mjs";
-import { Dispatchable, applyDispatchable } from "./Events/Concerns/Dispatchable.mjs";
 import { ModelEvent } from "./Database/Ensemble/Events/ModelEvent.mjs";
 import { ModelRetrieved } from "./Database/Ensemble/Events/ModelRetrieved.mjs";
 import { ModelCreating } from "./Database/Ensemble/Events/ModelCreating.mjs";

package/docs/events-typescript-usage.md

@@ -0,0 +1,126 @@
+# Events TypeScript Usage Guide
+
+## Problem: TypeScript doesn't recognize static dispatch methods
+
+When you create an event class that extends `Event`, TypeScript may not automatically recognize the static `dispatch()`, `dispatchIf()`, `dispatchUnless()`, and `until()` methods that are added by the Dispatchable mixin.
+
+```typescript
+import { Event } from '@orchestr-sh/orchestr';
+
+class UserRegistered extends Event {
+  constructor(public user: User) {
+    super();
+  }
+}
+
+// TypeScript error: Property 'dispatch' does not exist on type 'typeof UserRegistered'
+UserRegistered.dispatch(user);
+```
+
+## Solution 1: Use type assertion (Quick Fix)
+
+The simplest solution is to cast your event class to the `EventClass` type:
+
+```typescript
+import { Event, type EventClass } from '@orchestr-sh/orchestr';
+
+class UserRegistered extends Event {
+  constructor(public user: User) {
+    super();
+  }
+}
+
+// Cast to EventClass to get proper typing
+const UserRegisteredEvent = UserRegistered as EventClass<UserRegistered>;
+
+// Now TypeScript recognizes the static methods
+UserRegisteredEvent.dispatch(user);
+UserRegisteredEvent.dispatchIf(condition, user);
+UserRegisteredEvent.dispatchUnless(condition, user);
+await UserRegisteredEvent.until(user);
+```
+
+## Solution 2: Use Event facade (Recommended)
+
+The recommended approach is to use the Event facade for dispatching. You can import it in two ways:
+
+**Option A: Subpath import (cleaner)**
+```typescript
+import { Event } from '@orchestr-sh/orchestr/Facades';
+
+class UserRegistered extends Event {
+  constructor(public user: User) {
+    super();
+  }
+}
+
+// Dispatch through the facade - fully typed
+Event.dispatch(new UserRegistered(user));
+Event.dispatchIf(condition, new UserRegistered(user));
+Event.dispatchUnless(condition, new UserRegistered(user));
+await Event.until(new UserRegistered(user));
+```
+
+**Option B: Named import from main package**
+```typescript
+import { EventFacade } from '@orchestr-sh/orchestr';
+
+// Use EventFacade to avoid naming conflict with Event base class
+EventFacade.dispatch(new UserRegistered(user));
+```
+
+## Solution 3: Export with proper typing
+
+Export your event classes with the proper type in your event files:
+
+```typescript
+// UserRegistered.ts
+import { Event, type EventClass } from '@orchestr-sh/orchestr';
+
+class UserRegisteredClass extends Event {
+  constructor(public user: User) {
+    super();
+  }
+}
+
+// Export with proper typing
+export const UserRegistered = UserRegisteredClass as EventClass<UserRegisteredClass>;
+export type UserRegistered = InstanceType<typeof UserRegistered>;
+```
+
+Then use it elsewhere:
+
+```typescript
+import { UserRegistered } from './Events/UserRegistered';
+
+// Full TypeScript support
+UserRegistered.dispatch(user);
+UserRegistered.dispatchIf(condition, user);
+```
+
+## Why This Happens
+
+The static methods (`dispatch`, `dispatchIf`, etc.) are added to the Event class at runtime by the `applyDispatchable()` function, which uses JavaScript's `Object.defineProperty`. TypeScript's type system doesn't automatically detect these runtime-added methods.
+
+The `EventClass<T>` type helper provides the correct type information to TypeScript, telling it that these static methods exist on your event class.
+
+## Best Practice Recommendation
+
+For most use cases, we recommend **Solution 2** (using the Event facade):
+
+```typescript
+Event.dispatch(new UserRegistered(user));
+```
+
+This approach:
+- ✅ Has full TypeScript support out of the box
+- ✅ Is more explicit and easier to understand
+- ✅ Works consistently across all event classes
+- ✅ Follows Laravel's recommended pattern
+- ✅ Makes testing easier (Event.fake() works seamlessly)
+
+Reserve the static class methods for cases where you want the syntactic sugar:
+
+```typescript
+UserRegistered.dispatch(user);  // Shorter, but requires type casting
+```

package/docs/future-improvements.md

@@ -0,0 +1,49 @@
+# Future Improvements
+
+## Traits Refactoring (Deferred)
+
+**Goal:** Refactor all mixins to use `@orchestr-sh/traits` for better PHP-like syntax and automatic TypeScript support.
+
+### Current Mixins to Migrate
+1. **Dispatchable** (Events) - Low risk, good starting point
+2. **HasDynamicRelations** (Ensemble) - Medium risk, uses Proxies
+3. **HasRelationships** (Ensemble) - High risk, core ORM functionality
+
+### Benefits
+- Eliminate need for `EventClass` type helper
+- More PHP-like trait syntax
+- Better TypeScript inference
+- Cleaner, more maintainable code
+
+### Prerequisites Before Starting
+1. ✅ Validate `@orchestr-sh/traits` handles:
+   - Static methods (e.g., `Dispatchable.dispatch()`)
+   - Property conflicts between traits
+   - Interaction with existing decorators (@DynamicRelation)
+   - Proxy objects (HasDynamicRelations)
+2. ✅ Create POC with Dispatchable trait only
+3. ✅ Verify test coverage is sufficient to catch regressions
+4. ✅ Gather user feedback on current DX - is this actually a pain point?
+
+### Migration Strategy (When Ready)
+**Phase 1:** Dispatchable trait (lowest risk)
+- Migrate Events/Concerns/Dispatchable to use traits
+- Ship and validate in production
+- Measure DX improvement
+
+**Phase 2:** HasDynamicRelations (if Phase 1 succeeds)
+- More complex due to Proxy usage
+- Test thoroughly with all relationship types
+
+**Phase 3:** HasRelationships (highest risk, save for last)
+- Core ORM functionality
+- Affects all models and relationships
+- Extensive testing required
+
+### Decision: Deferred
+**Reason:** Current implementation is production-ready (9.9/10 code review). The TypeScript typing issue has documented workarounds. No user pain point driving this change. Premature to refactor stable code.
+
+**Revisit when:**
+- Users report DX friction with current approach
+- `@orchestr-sh/traits` is proven in production
+- We have capacity for the migration effort

package/docs/validation.md

@@ -0,0 +1,201 @@
+# Validation Usage
+
+This guide shows how to validate request data using the Validator and the Rule builder. It covers defining rules, conditional logic, arrays, dates, numbers, networks and files, plus customizing error messages.
+
+## Quick Start
+
+- Create a Validator with input data and a rules object.
+- Use the Rule builder to compose rule instances.
+- Call `validate()` to run rules; read `errors()` for messages.
+
+```ts
+import { Validator } from '@/Foundation/Http/Validator';
+import { Rule } from '@/Foundation/Http/Rule';
+
+const data = { email: 'user@example.com', age: 18 };
+const rules = {
+  email: [Rule.required(), Rule.email()],
+  age: [Rule.required(), Rule.integer(), Rule.min(18)],
+};
+
+const v = new Validator(data, rules);
+const ok = await v.validate(); // true/false
+const errs = v.errors(); // { email?: string[], age?: string[] }
+```
+
+## Rule Builder
+
+Use `Rule.*()` methods to construct validation rules. Every call returns a rule object. Common examples:
+
+- Presence: `required()`, `present()`, `filled()`, `nullable()`, `sometimes()`
+- Strings: `string()`, `alpha()`, `alphaNum()`, `alphaDash()`, `lowercase()`, `uppercase()`, `ascii()`
+- Patterns: `regex(/.../)`, `notRegex(/.../)`, `email()`, `json()`
+- Numbers: `numeric()`, `integer()`, `decimal(places?)`, `min(n)`, `max(n)`, `between(min,max)`, `size(n)`
+- Digits: `digits(n)`, `digitsBetween(min,max)`, `minDigits(n)`, `maxDigits(n)`, `multipleOf(n)`
+- Comparison: `gt(fieldOrValue)`, `gte(fieldOrValue)`, `lt(fieldOrValue)`, `lte(fieldOrValue)`
+- Arrays: `array()`, `distinct()`, `in([...])`, `notIn([...])`, `inArray(field)`
+- Dates: `date()`, `dateEquals(date)`, `after(dateOrField)`, `afterOrEqual(...)`, `before(...)`, `beforeOrEqual(...)`
+- Network: `url()`, `activeUrl()`, `ip()`, `ipv4()`, `ipv6()`, `macAddress()`, `uuid()`, `timezone()`
+- Files: `file()`, `image()`, `mimetypes([...])`, `mimes([...])`
+- Conditionals: `accepted()`, `acceptedIf(field,val)`, `declined()`, `declinedIf(field,val)`
+
+## Conditional Presence
+
+Require a field based on other inputs:
+
+```ts
+const rules = {
+  type: [Rule.required(), Rule.string()],
+  cc: [Rule.requiredIf('type', 'card')], // required when type == 'card'
+};
+```
+
+Other variants:
+
+- `requiredUnless(field, val)`
+- `requiredWith(...fields)`
+- `requiredWithAll(...fields)`
+- `requiredWithout(...fields)`
+- `requiredWithoutAll(...fields)`
+
+Prohibited variants:
+
+- `prohibited()`
+- `prohibitedIf(field, val)`
+- `prohibitedUnless(field, val)`
+- `prohibits(...fields)` (current field prohibits the listed fields)
+
+## Starts/Ends With
+
+```ts
+const rules = {
+  slug: [Rule.startsWith(['user']), Rule.endsWith(['admin'])],
+};
+```
+
+## Comparisons
+
+Compare against another field or literal:
+
+```ts
+const rules = {
+  max: [Rule.gt('min')],       // max > min
+  threshold: [Rule.gte(10)],   // threshold >= 10
+};
+```
+
+## Arrays
+
+```ts
+const rules = {
+  tags: [Rule.array(), Rule.distinct()],
+  choice: [Rule.inArray('choices')],
+  status: [Rule.in(['open', 'closed'])],
+};
+```
+
+## Dates
+
+```ts
+const rules = {
+  start: [Rule.date(), Rule.after('2020-01-01')],
+  end: [Rule.date(), Rule.afterOrEqual('start')],
+};
+```
+
+## Files
+
+```ts
+const rules = {
+  avatar: [Rule.file(), Rule.image(), Rule.mimes(['png','jpg'])],
+  doc: [Rule.file(), Rule.mimetypes(['application/pdf'])],
+};
+```
+
+## Custom Messages
+
+Pass per-field messages via the Validator:
+
+```ts
+const messages = {
+  'email.required': 'Email is required',
+  'email.email': 'Email must be valid',
+};
+const v = new Validator(data, rules, messages);
+```
+
+Rule classes may also provide tailored messages when they are invokable; otherwise messages fall back to defaults.
+
+## Form Requests
+
+Encapsulate validation by extending `FormRequest`. Define `rules()` and `messages()` then call `validated()`:
+
+```ts
+import { FormRequest } from '@/Foundation/Http/FormRequest';
+import { Rule } from '@/Foundation/Http/Rule';
+
+class CreateUserRequest extends FormRequest {
+  rules() {
+    return {
+      email: [Rule.required(), Rule.email()],
+      password: [Rule.required(), Rule.string(), Rule.min(8)],
+    };
+  }
+  messages() {
+    return {
+      'password.min': 'Password must be at least 8 characters',
+    };
+  }
+}
+```
+
+Use it in your controller/handler to validate and access sanitized inputs.
+
+## Auth Validation
+
+Some rules interact with authentication and require app-specific wiring:
+
+- current_password
+  - Recognized as a token; by default it passes until you connect it to your auth system.
+  - Use as a string rule: 
+    ```ts
+    const rules = { current_password: 'current_password' };
+    ```
+  - Integration options:
+    - Prefer user identity checks in `FormRequest.authorize()`.
+    - Or provide a custom invokable rule that verifies the password:
+      ```ts
+      import { BaseRule } from '@/Foundation/Http/Rules';
+      import { Auth } from '@/Auth'; // your auth API
+      class CurrentPasswordRule extends BaseRule {
+        constructor() { super('current_password'); this.invokable = true; }
+        async passes(_attr: string, value: any): Promise<boolean> {
+          const user = Auth.user();
+          if (!user) return false;
+          return Auth.verify(user, String(value));
+        }
+        messageFor(attribute: string) { return `The ${attribute} is incorrect.`; }
+      }
+      const rules = { current_password: [new CurrentPasswordRule()] };
+      ```
+
+- password
+  - Builder: `Rule.password()`; enforcement is application-defined.
+  - Recommended: express policy via built-in tokens (`string|min|max|confirmed|regex`) or a custom invokable rule that centralizes password policy checks.
+
+- can:ability
+  - Builder: `Rule.can('update-post')` returns a token.
+  - Recommended: perform authorization in `FormRequest.authorize()`; use validation for data constraints. If you need field-level gating, implement an invokable rule that queries your Gate/Policy and returns an error message when unauthorized.
+
+## Error Handling
+
+- `validate()` returns `true/false`
+- `errors()` returns a map of field → error messages
+- Throw `ValidationException` or handle manually depending on your flow
+
+## Tips
+
+- Chain rules in arrays to compose complex constraints
+- Prefer field comparisons (gt/gte/lt/lte) for relational checks
+- Use conditional presence for dynamic forms
+- Keep messages clear and domain-specific for better UX

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orchestr-sh/orchestr",
   "type": "module",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "A 1:1 Laravel replica in TypeScript - Brings Laravel's elegant syntax and architecture to Node.js",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -24,19 +24,57 @@
     }
   },
   "bin": {
-    "orchestr": "dist/Console/orchestr.js"
+    "orchestr": "dist/Console/orchestr.mjs"
   },
   "files": [
     "dist",
-    "README.md",
-    "LICENSE"
+    "docs",
+    "CODE_OF_CONDUCT.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "LICENSE",
+    "README.md"
   ],
   "release": {
     "branches": [
       "main"
     ],
     "plugins": [
-      "@semantic-release/commit-analyzer",
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "releaseRules": [
+            {
+              "type": "build",
+              "release": "patch"
+            },
+            {
+              "type": "ci",
+              "release": "patch"
+            },
+            {
+              "type": "chore",
+              "release": "patch"
+            },
+            {
+              "type": "docs",
+              "release": "patch"
+            },
+            {
+              "type": "refactor",
+              "release": "patch"
+            },
+            {
+              "type": "style",
+              "release": "patch"
+            },
+            {
+              "type": "test",
+              "release": "patch"
+            }
+          ]
+        }
+      ],
       "@semantic-release/release-notes-generator",
       [
         "@semantic-release/changelog",
@@ -46,21 +84,17 @@
       ],
       "@semantic-release/npm",
       [
-        "@semantic-release/github",
+        "@semantic-release/git",
         {
           "assets": [
-            "dist",
-            "docs",
             "package.json",
             "package-lock.json",
-            "CODE_OF_CONDUCT.md",
-            "CHANGELOG.md",
-            "CONTRIBUTING.md",
-            "LICENSE",
-            "README.md"
-          ]
+            "CHANGELOG.md"
+          ],
+          "message": "chore(version): release ${nextRelease.version} [skip ci]"
         }
-      ]
+      ],
+      "@semantic-release/github"
     ]
   },
   "commitlint": {
@@ -114,7 +148,7 @@
   },
   "homepage": "https://github.com/orchestr-sh/orchestr#readme",
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.14.0"
   },
   "dependencies": {
     "drizzle-orm": ">=0.30.0",
@@ -128,9 +162,9 @@
     "@vitest/coverage-v8": "^4.1.2",
     "husky": "^9.1.7",
     "lint-staged": "^16.4.0",
-    "oxfmt": "^0.43.0",
-    "oxlint": "^1.58.0",
-    "oxlint-tsgolint": "^0.19.0",
+    "oxfmt": "^0.44.0",
+    "oxlint": "^1.59.0",
+    "oxlint-tsgolint": "^0.20.0",
     "tsdown": "^0.21.7",
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",