@orchestr-sh/orchestr 1.1.1 → 1.2.1

package/README.md

@@ -1,4 +1,4 @@
-# Laravel-Next
+# Orchestr
 
 A 1:1 Laravel replica built in TypeScript. Brings Laravel's elegant syntax and architecture to the TypeScript/Node.js ecosystem.
 
@@ -8,17 +8,20 @@ Built from the ground up with Laravel's core components:
 
 - **Service Container** - Full IoC container with dependency injection and reflection
 - **Service Providers** - Bootstrap and register services
-- **HTTP Router** - Laravel-style routing with parameter binding
+- **HTTP Router** - Laravel-style routing with parameter binding and file-based route loading
 - **Request/Response** - Elegant HTTP abstractions
 - **Middleware** - Global and route-level middleware pipeline
 - **Controllers** - MVC architecture support
-- **Facades** - Static proxy access to services
+- **Facades** - Static proxy access to services (Route, DB)
+- **Query Builder** - Fluent database query builder with full Laravel API
+- **Ensemble ORM** - ActiveRecord ORM (Laravel's Eloquent equivalent) with relationships, soft deletes, and more
+- **Database Manager** - Multi-connection database management
 - **Application Lifecycle** - Complete Laravel bootstrap process
 
 ## Installation
 
 ```bash
-npm install orchestr reflect-metadata
+npm install @orchestr-sh/orchestr reflect-metadata
 ```
 
 **Note**: `reflect-metadata` is required for dependency injection to work.
@@ -34,14 +37,14 @@ const app = new Application(__dirname);
 
 // Register providers
 app.register(RouteServiceProvider);
-app.boot();
+await app.boot();
 
 // Create HTTP kernel
 const kernel = new Kernel(app);
 
 // Define routes
 Route.get('/', async (req, res) => {
-  return res.json({ message: 'Hello from Laravel-Next!' });
+  return res.json({ message: 'Hello from Orchestr!' });
 });
 
 Route.get('/users/:id', async (req, res) => {
@@ -121,6 +124,69 @@ const route = Route.get('/users', handler);
 route.setName('users.index');
 ```
 
+#### Loading Routes from Files
+
+Organize your routes in separate files, just like Laravel:
+
+**routes/web.ts**
+```typescript
+import { Route } from 'orchestr';
+
+Route.get('/', async (req, res) => {
+  return res.json({ message: 'Welcome' });
+});
+
+Route.get('/about', async (req, res) => {
+  return res.json({ page: 'about' });
+});
+```
+
+**routes/api.ts**
+```typescript
+import { Route } from 'orchestr';
+
+Route.group({ prefix: 'api/v1' }, () => {
+  Route.get('/users', async (req, res) => {
+    return res.json({ users: [] });
+  });
+
+  Route.post('/users', async (req, res) => {
+    return res.status(201).json({ created: true });
+  });
+});
+```
+
+**app/Providers/AppRouteServiceProvider.ts**
+```typescript
+import { RouteServiceProvider } from 'orchestr';
+
+export class AppRouteServiceProvider extends RouteServiceProvider {
+  async boot(): Promise<void> {
+    // Load web routes
+    this.routes(() => import('../../routes/web'));
+
+    // Load API routes
+    this.routes(() => import('../../routes/api'));
+
+    await super.boot();
+  }
+}
+```
+
+**index.ts**
+```typescript
+import 'reflect-metadata';
+import { Application, Kernel } from 'orchestr';
+import { AppRouteServiceProvider } from './app/Providers/AppRouteServiceProvider';
+
+const app = new Application(__dirname);
+app.register(AppRouteServiceProvider);
+await app.boot();
+
+const kernel = new Kernel(app);
+kernel.listen(3000);
+```
+
 ### Middleware
 
 Global and route-level middleware:
@@ -148,6 +214,8 @@ Route.get('/profile', handler).addMiddleware(authMiddleware);
 MVC pattern with base controller:
 
 ```typescript
+import { Controller, Request, Response, Route } from 'orchestr';
+
 class UserController extends Controller {
   async index(req: Request, res: Response) {
     return res.json({ users: [] });
@@ -166,6 +234,11 @@ class UserController extends Controller {
     return res.status(201).json({ user: validated });
   }
 }
+
+// Register controller routes
+Route.get('/users', [UserController, 'index']);
+Route.get('/users/:id', [UserController, 'show']);
+Route.post('/users', [UserController, 'store']);
 ```
 
 ### Request
@@ -234,7 +307,7 @@ res.view('welcome', { name: 'John' });
 Static access to services:
 
 ```typescript
-import { Route } from 'orchestr';
+import { Route, DB } from 'orchestr';
 
 // Route facade provides static access to Router
 Route.get('/path', handler);
@@ -242,52 +315,358 @@ Route.post('/path', handler);
 Route.group({ prefix: 'api' }, () => {
   // ...
 });
+
+// DB facade provides static access to DatabaseManager
+const users = await DB.table('users').where('active', true).get();
 ```
 
-## Example Application
+### Database Query Builder
 
-Run the example application:
+Fluent, chainable query builder with full Laravel API:
 
-```bash
-npm run dev
+```typescript
+import { DB } from 'orchestr';
+
+// Basic queries
+const users = await DB.table('users').get();
+const user = await DB.table('users').where('id', 1).first();
+
+// Where clauses
+await DB.table('users')
+  .where('votes', '>', 100)
+  .where('status', 'active')
+  .get();
+
+// Or where
+await DB.table('users')
+  .where('votes', '>', 100)
+  .orWhere('name', 'John')
+  .get();
+
+// Additional where methods
+await DB.table('users').whereBetween('votes', [1, 100]).get();
+await DB.table('users').whereIn('id', [1, 2, 3]).get();
+await DB.table('users').whereNull('deleted_at').get();
+
+// Ordering, grouping, and limits
+await DB.table('users')
+  .orderBy('name', 'desc')
+  .groupBy('account_id')
+  .having('account_id', '>', 100)
+  .limit(10)
+  .offset(20)
+  .get();
+
+// Joins
+await DB.table('users')
+  .join('contacts', 'users.id', '=', 'contacts.user_id')
+  .leftJoin('orders', 'users.id', '=', 'orders.user_id')
+  .select('users.*', 'contacts.phone', 'orders.price')
+  .get();
+
+// Aggregates
+const count = await DB.table('users').count();
+const max = await DB.table('orders').max('price');
+const min = await DB.table('orders').min('price');
+const avg = await DB.table('orders').avg('price');
+const sum = await DB.table('orders').sum('price');
+
+// Inserts
+await DB.table('users').insert({
+  name: 'John',
+  email: 'john@example.com'
+});
+
+// Updates
+await DB.table('users')
+  .where('id', 1)
+  .update({ votes: 1 });
+
+// Deletes
+await DB.table('users').where('votes', '<', 100).delete();
+
+// Raw expressions
+await DB.table('users')
+  .select(DB.raw('count(*) as user_count, status'))
+  .where('status', '<>', 1)
+  .groupBy('status')
+  .get();
 ```
 
-Visit `http://localhost:3000` to see it in action.
+### Ensemble ORM
+
+ActiveRecord ORM (Eloquent equivalent) with relationships and advanced features:
+
+```typescript
+import { Ensemble, EnsembleBuilder } from 'orchestr';
+
+// Define a model
+class User extends Ensemble {
+  protected table = 'users';
+  protected fillable = ['name', 'email', 'password'];
+  protected hidden = ['password'];
+  protected casts = {
+    email_verified_at: 'datetime',
+    is_admin: 'boolean'
+  };
+}
+
+// Query using the model
+const users = await User.query().where('active', true).get();
+const user = await User.query().find(1);
+
+// Create
+const user = new User();
+user.name = 'John Doe';
+user.email = 'john@example.com';
+await user.save();
+
+// Or use create
+const user = await User.query().create({
+  name: 'John Doe',
+  email: 'john@example.com'
+});
+
+// Update
+const user = await User.query().find(1);
+user.name = 'Jane Doe';
+await user.save();
+
+// Delete
+await user.delete();
+
+// Mass assignment
+await User.query().create({
+  name: 'John',
+  email: 'john@example.com'
+});
+
+// Soft deletes
+import { softDeletes } from 'orchestr';
+
+class Post extends softDeletes(Ensemble) {
+  protected table = 'posts';
+}
 
-Available routes in the example:
-- `GET /` - Welcome message
-- `GET /users/:id` - Get user by ID
-- `GET /search?q=query` - Search with query params
-- `POST /users` - Create user
-- `GET /api/v1/profile` - Protected route (requires auth header)
-- `POST /api/v1/posts` - Create post (protected)
-- `GET /posts/:postId/comments/:commentId` - Nested parameters
+const post = await Post.query().find(1);
+await post.delete(); // Soft delete
+await post.restore(); // Restore
+await post.forceDelete(); // Permanent delete
+
+// Query only non-deleted
+const posts = await Post.query().get();
+
+// Query with trashed
+const allPosts = await Post.query().withTrashed().get();
+
+// Query only trashed
+const trashedPosts = await Post.query().onlyTrashed().get();
+
+// Timestamps
+// Automatically manages created_at and updated_at
+class Article extends Ensemble {
+  protected table = 'articles';
+  public timestamps = true; // enabled by default
+}
+
+// Custom attributes and casts
+class User extends Ensemble {
+  protected casts = {
+    email_verified_at: 'datetime',
+    settings: 'json',
+    is_admin: 'boolean',
+    age: 'number'
+  };
+
+  // Accessors
+  getFullNameAttribute(): string {
+    return `${this.getAttribute('first_name')} ${this.getAttribute('last_name')}`;
+  }
+
+  // Mutators
+  setPasswordAttribute(value: string): void {
+    this.setAttribute('password', hashPassword(value));
+  }
+}
+
+const user = await User.query().find(1);
+console.log(user.full_name); // Uses accessor
+user.password = 'secret123'; // Uses mutator
+```
+
+### Database Setup
+
+Configure multiple database connections:
+
+```typescript
+import { Application, DatabaseServiceProvider, DB } from 'orchestr';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import Database from 'better-sqlite3';
+
+const app = new Application(__dirname);
+
+// Register database service provider
+app.register(new DatabaseServiceProvider({
+  default: 'sqlite',
+  connections: {
+    sqlite: {
+      adapter: 'drizzle',
+      client: drizzle(new Database('database.sqlite'))
+    },
+    postgres: {
+      adapter: 'drizzle',
+      client: drizzle(process.env.DATABASE_URL!)
+    }
+  }
+}));
+
+await app.boot();
+
+// Use default connection
+const users = await DB.table('users').get();
+
+// Use specific connection
+const posts = await DB.connection('postgres').table('posts').get();
+```
+
+## Complete Example
+
+Here's a complete example showing routing, database, and ORM:
+
+**index.ts**
+```typescript
+import 'reflect-metadata';
+import { Application, Kernel, DatabaseServiceProvider } from 'orchestr';
+import { AppRouteServiceProvider } from './app/Providers/AppRouteServiceProvider';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import Database from 'better-sqlite3';
+
+const app = new Application(__dirname);
+
+// Register database
+app.register(new DatabaseServiceProvider({
+  default: 'sqlite',
+  connections: {
+    sqlite: {
+      adapter: 'drizzle',
+      client: drizzle(new Database('database.sqlite'))
+    }
+  }
+}));
+
+// Register routes
+app.register(AppRouteServiceProvider);
+
+await app.boot();
+
+const kernel = new Kernel(app);
+kernel.listen(3000);
+```
+
+**app/Models/User.ts**
+```typescript
+import { Ensemble, softDeletes } from 'orchestr';
+
+export class User extends softDeletes(Ensemble) {
+  protected table = 'users';
+  protected fillable = ['name', 'email', 'password'];
+  protected hidden = ['password'];
+
+  protected casts = {
+    email_verified_at: 'datetime',
+    is_admin: 'boolean'
+  };
+}
+```
+
+**routes/api.ts**
+```typescript
+import { Route, DB } from 'orchestr';
+import { User } from '../app/Models/User';
+
+Route.group({ prefix: 'api' }, () => {
+  // Using query builder
+  Route.get('/users', async (req, res) => {
+    const users = await DB.table('users')
+      .where('active', true)
+      .orderBy('created_at', 'desc')
+      .get();
+
+    return res.json({ users });
+  });
+
+  // Using Ensemble ORM
+  Route.get('/users/:id', async (req, res) => {
+    const user = await User.query().find(req.routeParam('id'));
+
+    if (!user) {
+      return res.status(404).json({ message: 'User not found' });
+    }
+
+    return res.json({ user });
+  });
+
+  Route.post('/users', async (req, res) => {
+    const user = await User.query().create(
+      req.only(['name', 'email', 'password'])
+    );
+
+    return res.status(201).json({ user });
+  });
+
+  Route.delete('/users/:id', async (req, res) => {
+    const user = await User.query().find(req.routeParam('id'));
+    await user?.delete(); // Soft delete
+
+    return res.json({ message: 'User deleted' });
+  });
+});
+```
 
 ## Architecture
 
-Laravel-Next follows Laravel's architecture exactly:
+Orchestr follows Laravel's architecture exactly:
 
 ```
 src/
 ├── Container/
-│   └── Container.ts          # IoC Container with DI
+│   └── Container.ts              # IoC Container with DI
 ├── Foundation/
-│   ├── Application.ts        # Core application class
-│   ├── ServiceProvider.ts    # Service provider base
+│   ├── Application.ts            # Core application class
+│   ├── ServiceProvider.ts        # Service provider base
 │   └── Http/
-│       └── Kernel.ts         # HTTP kernel
+│       └── Kernel.ts             # HTTP kernel
 ├── Routing/
-│   ├── Router.ts             # Route registration and dispatch
-│   ├── Route.ts              # Individual route
-│   ├── Request.ts            # HTTP request wrapper
-│   ├── Response.ts           # HTTP response wrapper
-│   └── Controller.ts         # Base controller
+│   ├── Router.ts                 # Route registration and dispatch
+│   ├── Route.ts                  # Individual route
+│   ├── Request.ts                # HTTP request wrapper
+│   ├── Response.ts               # HTTP response wrapper
+│   └── Controller.ts             # Base controller
+├── Database/
+│   ├── DatabaseManager.ts        # Multi-connection manager
+│   ├── Connection.ts             # Database connection
+│   ├── Query/
+│   │   ├── Builder.ts            # Query builder
+│   │   └── Expression.ts         # Raw SQL expressions
+│   ├── Ensemble/
+│   │   ├── Ensemble.ts           # Base ORM model (like Eloquent)
+│   │   ├── EnsembleBuilder.ts    # Model query builder
+│   │   ├── EnsembleCollection.ts # Model collection
+│   │   ├── SoftDeletes.ts        # Soft delete trait
+│   │   └── Concerns/
+│   │       ├── HasAttributes.ts  # Attribute handling & casting
+│   │       └── HasTimestamps.ts  # Timestamp management
+│   ├── Adapters/
+│   │   └── DrizzleAdapter.ts     # Drizzle ORM adapter
+│   └── DatabaseServiceProvider.ts
 ├── Support/
-│   └── Facade.ts             # Facade base class
+│   ├── Facade.ts                 # Facade base class
+│   └── helpers.ts                # Helper functions
 ├── Facades/
-│   └── Route.ts              # Route facade
+│   ├── Route.ts                  # Route facade
+│   └── DB.ts                     # Database facade
 └── Providers/
-    └── RouteServiceProvider.ts
+    └── RouteServiceProvider.ts   # Route service provider
 ```
 
 ## TypeScript Benefits
@@ -302,10 +681,23 @@ While maintaining Laravel's API, you get:
 
 ## Roadmap
 
-This is the core foundation. Next components to build:
-
-- [ ] Database Query Builder
-- [ ] Eloquent ORM
+Core components completed and in progress:
+
+- [x] Service Container & Dependency Injection
+- [x] Service Providers
+- [x] HTTP Router & Route Files
+- [x] Request/Response
+- [x] Middleware Pipeline
+- [x] Controllers
+- [x] Facades (Route, DB)
+- [x] Database Query Builder
+- [x] Ensemble ORM (Eloquent equivalent)
+- [x] Multi-connection Database Manager
+- [x] Soft Deletes
+- [x] Model Attributes & Casting
+- [ ] Model Relationships (HasMany, BelongsTo, etc.)
+- [ ] Database Migrations
+- [ ] Database Seeding
 - [ ] Validation System
 - [ ] Authentication & Authorization
 - [ ] Queue System
@@ -323,12 +715,19 @@ This is the core foundation. Next components to build:
 | Service Container | ✅ | ✅        |
 | Service Providers | ✅ | ✅        |
 | Routing | ✅ | ✅        |
+| Route Files | ✅ | ✅        |
 | Middleware | ✅ | ✅        |
 | Controllers | ✅ | ✅        |
 | Request/Response | ✅ | ✅        |
 | Facades | ✅ | ✅        |
-| Eloquent ORM | ✅ | 🚧       |
-| Query Builder | ✅ | 🚧       |
+| Query Builder | ✅ | ✅        |
+| Eloquent ORM | ✅ | ✅ (Ensemble)       |
+| Soft Deletes | ✅ | ✅        |
+| Timestamps | ✅ | ✅        |
+| Attribute Casting | ✅ | ✅        |
+| Model Relationships | ✅ | 🚧       |
+| Migrations | ✅ | 🚧       |
+| Seeding | ✅ | 🚧       |
 | Validation | ✅ | 🚧       |
 | Authentication | ✅ | 🚧       |
 | Authorization | ✅ | 🚧       |

package/dist/Foundation/Application.d.ts

@@ -46,7 +46,7 @@ export declare class Application extends Container {
     /**
      * Boot the application's service providers
      */
-    boot(): void;
+    boot(): Promise<void>;
     /**
      * Boot the given service provider
      */

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;AAEpD;;;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;IAO5C;;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;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;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;AAEpD;;;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;IAO5C;;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"}

package/dist/Foundation/Application.js

@@ -102,19 +102,24 @@ class Application extends Container_1.Container {
     /**
      * Boot the application's service providers
      */
-    boot() {
+    async boot() {
         if (this.booted) {
             return;
         }
-        this.serviceProviders.forEach(provider => this.bootProvider(provider));
+        for (const provider of this.serviceProviders) {
+            await this.bootProvider(provider);
+        }
         this.booted = true;
     }
     /**
      * Boot the given service provider
      */
-    bootProvider(provider) {
+    async bootProvider(provider) {
         if (typeof provider.boot === 'function') {
-            this.call(provider.boot.bind(provider));
+            const result = this.call(provider.boot.bind(provider));
+            if (result instanceof Promise) {
+                await result;
+            }
         }
     }
     /**

package/dist/Foundation/Application.js.map

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

package/dist/Providers/RouteServiceProvider.d.ts

@@ -1,9 +1,30 @@
 import { ServiceProvider } from '../Foundation/ServiceProvider';
 /**
  * RouteServiceProvider - Registers the router in the container
+ * Similar to Laravel's RouteServiceProvider
  */
 export declare class RouteServiceProvider extends ServiceProvider {
+    /**
+     * The path to the route files
+     * Override this in your app's RouteServiceProvider
+     */
+    protected routesPath?: string;
+    /**
+     * Route file loaders
+     * Override this method to customize how routes are loaded
+     */
+    protected routeLoaders: (() => void | Promise<void>)[];
     register(): void;
-    boot(): void;
+    boot(): Promise<void>;
+    /**
+     * Load routes from a file or callback
+     * Laravel: $this->routes(function() { require base_path('routes/web.php'); })
+     */
+    protected routes(callback: () => void | Promise<void>): this;
+    /**
+     * Load routes from a module
+     * Usage: loadRoutesFrom(() => import('../routes/web'))
+     */
+    protected loadRoutesFrom(importer: () => Promise<any>): Promise<void>;
 }
 //# sourceMappingURL=RouteServiceProvider.d.ts.map

package/dist/Providers/RouteServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouteServiceProvider.d.ts","sourceRoot":"","sources":["../../src/Providers/RouteServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;IACvD,QAAQ,IAAI,IAAI;IAQhB,IAAI,IAAI,IAAI;CAGb"}
+{"version":3,"file":"RouteServiceProvider.d.ts","sourceRoot":"","sources":["../../src/Providers/RouteServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;IACvD;;;OAGG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,CAAC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAM;IAE5D,QAAQ,IAAI,IAAI;IAQV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAK5D;;;OAGG;cACa,cAAc,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAG5E"}