arikajs 0.10.6 → 0.10.8

package/README.md

@@ -15,7 +15,7 @@
 [![GitHub issues](https://img.shields.io/github/issues/arikajs/arikajs.svg?style=flat-square)](https://github.com/arikajs/arikajs/issues)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/arikajs/arikajs/pulls)
 
-[Quick Start](#quick-start) | [Examples](https://github.com/arikajs/examples) | [Community](https://discord.gg/arikajs)
+[Quick Start](#quick-start) | [Core Modules](#-the-arikajs-ecosystem) | [Documentation](https://arikajs.com) | [Discord](https://discord.gg/arikajs)
 
 </div>
 
@@ -23,435 +23,120 @@
 
 ## 🚀 What is ArikaJS?
 
-ArikaJS is a **modern, elegant, and powerful** Node.js framework that brings enterprise-grade features and developer-friendly patterns to the TypeScript/JavaScript ecosystem. Built from the ground up with TypeScript, ArikaJS provides a robust foundation for building scalable web applications and APIs with an intuitive, expressive syntax.
-
-### ✨ Key Features
-
-- 🎯 **Elegant Syntax** - Clean, expressive code that's a joy to write
-- 🔥 **TypeScript First** - Full TypeScript support with excellent type inference
-- 🛣️ **Powerful Routing** - Intuitive routing with implicit model binding
-- 💉 **Dependency Injection** - Built-in IoC container for clean architecture
-- 🗄️ **Active Record ORM** - Eloquent-inspired database layer
-- 🔐 **Authentication & Authorization** - Built-in auth system with guards and policies
-- ✅ **Validation** - Comprehensive request validation
-- 📧 **Mail & Notifications** - Easy email and notification system
-- 🔄 **Queue System** - Background job processing
-- 📦 **Service Providers** - Modular application architecture
-- 🎨 **Template Engine** - Flexible view rendering
-- ⚡ **Event System** - Decouple your application with powerful events and listeners
-- 🧪 **Testing Ready** - Built with testing in mind
-- 🛠️ **Global Helpers** - Intuitive functions like `app()`, `config()`, and `route()`
+ArikaJS is a **modern, elegant, and powerful** full-stack framework for Node.js. It is designed to provide an unparalleled developer experience by bringing enterprise-grade architecture patterns (inspired by Laravel and NestJS) into a native, high-performance TypeScript environment.
 
----
-
-## 📦 Installation
-
-### Option 1: Quick Start (Using npx)
-
-The fastest way to create a new ArikaJS project is using `npx`. No installation required!
-
-```bash
-# Create a new project
-npx @arikajs/cli new my-app
-
-# Navigate to your project
-cd my-app
+Whether you're building a simple REST API or a complex enterprise monolith, ArikaJS provides the tools you need—from a powerful ORM and background queues to expressive routing and real-time event broadcasting.
 
-# Start developing
-npm run dev
-```
+---
 
-### Option 2: Global Installation
+## ✨ Key Features
 
-If you prefer to have the `arika` command available everywhere, you can install the CLI globally:
+- 🎯 **Elegant Syntax** - Expressive, readable code that minimizes boilerplate.
+- 🔥 **TypeScript First** - Deeply integrated type safety with zero-config setup.
+- 🏛️ **Modular Monorepo** - Built as a collection of decoupled, high-quality packages.
+- 🗄️ **Active Record ORM** - An intuitive, Fluent interface for database interactions.
+- 💉 **IoC & Dependency Injection** - Powerful service container for decoupled architecture.
+- 🔐 **Auth & Authorization** - Guards, Policies, and multi-provider authentication.
+- 🔄 **Queue & Scheduler** - Background jobs and Cron-like task scheduling.
+- 🌍 **Localization (i18n)** - Built-in support for multi-language applications.
+- 📅 **Carbon Date API** - Elegant date and time manipulation.
+- 🎨 **Templating** - Lightning-fast Arika View engine with layout support.
+- 🧪 **First-Class Testing** - Built-in testing helpers and assertions.
 
-```bash
-# Install the CLI globally
-npm install -g @arikajs/cli
-
-# Create a new project
-arika new my-app
-```
+---
 
-# Install dependencies
-npm install
+## 📦 The ArikaJS Ecosystem
+
+ArikaJS is composed of specialized modules that can be used together or independently.
+
+| Package | Purpose |
+| :--- | :--- |
+| **`arikajs`** | The core framework wrapper and "glue" |
+| **`@arikajs/cli`** | Scaffolding, migrations, and local development |
+| **`@arikajs/database`** | Database layer, Schema builder, and ORM |
+| **`@arikajs/auth`** | Authentication (Web Session, JWT, API tokens) |
+| **`@arikajs/queue`** | Redis/Database/Sync background job processing |
+| **`@arikajs/scheduler`** | Fluid task scheduling for your application |
+| **`@arikajs/carbon`** | Powerful, fluent date manipulation (Carbon JS) |
+| **`@arikajs/view`** | Expressive template engine (Blade-inspired) |
+| **`@arikajs/cache`** | High-performance multi-driver caching |
+| **`@arikajs/mail`** | Fluent email API with SMTP, Log, and SES support |
+| **`@arikajs/events`** | Event-driven architecture with listeners |
+| **`@arikajs/validation`** | Powerful, schema-based request validation |
 
-# Start the development server
-npm run dev
-```
+---
 
-Your application will be running at `http://localhost:8000` 🎉
+## 🚦 Quick Start
 
-### Manual Installation
+Create your first ArikaJS project in seconds:
 
 ```bash
-# Create a new project directory
-mkdir my-app && cd my-app
-
-# Initialize npm
-npm init -y
-
-# Install ArikaJS
-npm install arikajs
+# Scaffold a new application
+npx @arikajs/cli@latest new my-app
 
-# Install dev dependencies
-npm install -D @arikajs/cli typescript tsx @types/node
-```
-
----
-
-## 🏗️ Project Structure
+# Navigate into the project
+cd my-app
 
-```
-my-app/
-├── app/
-│   ├── Controllers/       # HTTP controllers
-│   ├── Models/           # Database models
-│   ├── Middleware/       # Custom middleware
-│   └── Http/
-│       └── Kernel.ts     # HTTP kernel configuration
-├── bootstrap/
-│   └── app.ts           # Application bootstrap
-├── config/              # Configuration files
-│   ├── app.ts
-│   ├── database.ts
-│   └── logging.ts
-├── database/
-│   └── migrations/      # Database migrations
-├── routes/
-│   └── web.ts          # Route definitions
-├── server.ts           # Application entry point
-├── .env                # Environment variables
-└── package.json
+# Install dependencies and start development
+npm install && arika serve --dev
 ```
 
 ---
 
-## 📚 Basic Usage
-
-### Routing
-
-Define routes with an elegant, expressive syntax:
+## 📖 Basic Examples
 
+### Expressive Routing
 ```typescript
 import { Route } from 'arikajs';
 
-// Simple route
-Route.get('/', () => {
-    return { message: 'Welcome to ArikaJS!' };
-});
-
-// Route with parameters
-Route.get('/users/{id}', (request, id) => {
-    return { userId: id };
-});
+Route.get('/', () => 'Hello World');
 
-// Route groups with middleware
-Route.group({ middleware: 'auth' }, () => {
-    Route.get('/dashboard', [DashboardController, 'index']);
-    Route.post('/posts', [PostController, 'store']);
+Route.group({ prefix: 'api', middleware: 'auth' }, () => {
+    Route.get('/profile', [ProfileController, 'show']);
 });
 ```
 
-### Implicit Model Binding
-
-Automatically resolve models from route parameters:
-
+### Powerful ORM (Active Record)
 ```typescript
-import { Route } from 'arikajs';
-import User from './app/Models/User';
-
-// Register model binding
-Route.model('user', User);
-
-// The {user} parameter will automatically resolve to a User instance
-Route.get('/users/{user}', (request, user: User) => {
-    return {
-        message: 'User found!',
-        user: user
-    };
-});
-```
-
-### Controllers
-
-Create clean, organized controllers:
+const user = await User.where('email', 'prakash@example.com').first();
 
-```typescript
-import { Request, Response } from 'arikajs';
-import User from '../Models/User';
-
-export class UserController {
-    async index(request: Request, response: Response) {
-        const users = await User.all();
-        return response.json(users);
-    }
-
-    async show(request: Request, response: Response) {
-        const user = await User.findOrFail(request.params.id);
-        return response.json(user);
-    }
-
-    async store(request: Request, response: Response) {
-        const user = await User.create(request.body);
-        return response.status(201).json(user);
-    }
-}
+const posts = await user.posts().latest().get();
 ```
 
-### Models (Active Record)
-
-Work with databases using an elegant ORM:
-
+### Background Jobs
 ```typescript
-import { Model } from 'arikajs';
+import { dispatch } from '@arikajs/dispatcher';
 
-export default class User extends Model {
-    protected static tableName = 'users';
-
-    // Define relationships
-    posts() {
-        return this.hasMany(Post);
-    }
-
-    // Custom methods
-    async sendWelcomeEmail() {
-        // Send email logic
-    }
-}
-
-// Usage
-const user = await User.find(1);
-const posts = await user.posts().get();
-
-const newUser = await User.create({
-    name: 'John Doe',
-    email: 'john@example.com'
-});
+await dispatch(new ProcessVideoJob(videoPath));
 ```
 
-### Middleware
-
-Create custom middleware for request processing:
-
+### Fluent Date Handling (Carbon)
 ```typescript
-import { MiddlewareHandler, Request, Response } from 'arikajs';
+import { Carbon } from '@arikajs/carbon';
 
-export default class AuthMiddleware implements MiddlewareHandler {
-    async handle(request: Request, response: Response, next: Function) {
-        if (!request.headers.authorization) {
-            return response.status(401).json({ error: 'Unauthorized' });
-        }
-
-        return next();
-    }
-}
-```
-
-### Service Providers
-
-Organize your application with service providers:
-
-```typescript
-import { ServiceProvider } from 'arikajs';
-import { PaymentService } from './Services/PaymentService';
-
-export class PaymentServiceProvider extends ServiceProvider {
-    async register() {
-        this.app.singleton('payment', () => {
-            return new PaymentService(this.app.config().get('payment'));
-        });
-    }
-
-    async boot() {
-        // Bootstrap logic
-    }
-}
-```
-
-### 🛠️ Global Helpers
-
-ArikaJS provides several global helper functions to make your code more concise:
-
-```typescript
-import { app, config, route } from 'arikajs';
-
-// Access the application container
-const userService = app().make(UserService);
-
-// Get configuration values with defaults
-const debug = config('app.debug', false);
-
-// Generate URLs for named routes
-const profileUrl = route('users.show', { id: 1 });
-```
-
-### Database Migrations
-
-Manage your database schema with migrations:
-
-```typescript
-import { Migration, SchemaBuilder } from 'arikajs';
-
-export default class CreateUsersTable extends Migration {
-    async up(schema: SchemaBuilder) {
-        await schema.create('users', (table) => {
-            table.increments('id');
-            table.string('name');
-            table.string('email').unique();
-            table.string('password');
-            table.timestamps();
-        });
-    }
-
-    async down(schema: SchemaBuilder) {
-        await schema.dropIfExists('users');
-    }
-}
+const nextWeek = Carbon.now().addWeek().toDateTimeString();
+const diff = Carbon.parse(user.created_at).diffForHumans();
 ```
 
 ---
 
-## 🔧 Configuration
+## 🛠️ CLI Commands
 
-Configure your application in the `config/` directory:
-
-**config/app.ts**
-```typescript
-export default {
-    name: process.env.APP_NAME || 'ArikaJS',
-    env: process.env.NODE_ENV || 'development',
-    key: process.env.APP_KEY,
-    timezone: 'UTC',
-};
-```
-
-**config/database.ts**
-```typescript
-export default {
-    default: 'mysql',
-    connections: {
-        mysql: {
-            driver: 'mysql',
-            host: process.env.DB_HOST || 'localhost',
-            port: parseInt(process.env.DB_PORT || '3306'),
-            database: process.env.DB_DATABASE,
-            username: process.env.DB_USERNAME,
-            password: process.env.DB_PASSWORD,
-        },
-    },
-};
-```
-
----
-
-## 🎨 CLI Commands
-
-ArikaJS comes with a powerful CLI for common tasks:
+The ArikaJS CLI is your best friend during development.
 
 ```bash
-# Create a new application
-arika new my-app
-
-# Start development server
-arika serve --dev
-
-# Generate application key
-arika key:generate
-
-# Database migrations
-arika migrate
-arika migrate:rollback
-
-# Create migration
-arika make:migration create_posts_table
+arika list            # List all available commands
+arika help <command>  # Show detailed help for a specific command
+arika make:model      # Interactive menu to generate models/migrations
+arika migrate         # Run pending database migrations
+arika queue:work      # Start the background worker
 ```
 
 ---
 
-## 🧪 Testing
-
-ArikaJS is built with testing in mind:
-
-```typescript
-import { describe, it } from 'node:test';
-import assert from 'node:assert';
-import app from './bootstrap/app';
-
-describe('User API', () => {
-    it('should return all users', async () => {
-        const response = await app.get('/api/users');
-        assert.strictEqual(response.status, 200);
-    });
-});
-```
-
----
-
-## 📖 Documentation
-
-Comprehensive documentation is available in the [GitHub repository](https://github.com/arikajs/arikajs).
-
-For guides and examples, check out:
-- [Installation Guide](https://github.com/arikajs/arikajs#installation)
-- [Routing](https://github.com/arikajs/arikajs#routing)
-- [Controllers](https://github.com/arikajs/arikajs#controllers)
-- [Database & ORM](https://github.com/arikajs/arikajs#models-active-record)
-- [Examples](https://github.com/arikajs/examples)
-
----
-
-## 🏗 Architecture
-
-```text
-arikajs/
-├── src/
-│   ├── Contracts
-│   │   └── Application.ts
-│   ├── http
-│   │   ├── Middleware
-│   │   │   ├── RequestLoggingMiddleware.ts
-│   │   │   ├── ValidateRequestMiddleware.ts
-│   │   │   └── ViewMiddleware.ts
-│   │   ├── Handler.ts
-│   │   └── Kernel.ts
-│   ├── providers
-│   │   ├── AuthServiceProvider.ts
-│   │   ├── DatabaseServiceProvider.ts
-│   │   ├── EventsServiceProvider.ts
-│   │   ├── FrameworkServiceProvider.ts
-│   │   ├── HttpServiceProvider.ts
-│   │   ├── LoggingServiceProvider.ts
-│   │   ├── SchedulerServiceProvider.ts
-│   │   ├── ValidationServiceProvider.ts
-│   │   └── ViewServiceProvider.ts
-│   ├── Application.ts
-│   ├── createApp.ts
-│   ├── helpers.ts
-│   └── index.ts
-├── tests/
-├── package.json
-├── tsconfig.json
-└── README.md
-```
-
 ## 🤝 Contributing
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
-
-```bash
-# Clone the repository
-git clone https://github.com/arikajs/arikajs.git
-
-# Install dependencies
-npm install
-
-# Run tests
-npm test
-
-# Build the project
-npm run build
-```
+We love our community! Please see our [Contributing Guide](CONTRIBUTING.md) to learn how you can help make ArikaJS even better.
 
 ---
 
@@ -459,13 +144,11 @@ npm run build
 
 ArikaJS is open-sourced software licensed under the [MIT license](LICENSE).
 
----
-
-## 🙏 Acknowledgments
+<div align="center">
 
-ArikaJS draws inspiration from the best practices and patterns of modern web frameworks, including elegant API design, developer experience focus, and enterprise-grade architecture.
+**Built with ❤️ by [Prakash Tank](https://github.com/prakashtank) & The ArikaJS Team**
 
----
+</div>
 
 ## 💬 Community & Support
 

package/dist/Application.d.ts

@@ -6,6 +6,7 @@ export declare class Application extends FoundationApplication implements Applic
     protected router: Router;
     protected server?: any;
     protected isTerminating: boolean;
+    protected _commands: any[];
     constructor(basePath?: string);
     boot(): Promise<void>;
     version(): string;
@@ -37,10 +38,22 @@ export declare class Application extends FoundationApplication implements Applic
      * Get the HTTP server callback for raw http.createServer() usage.
      */
     getCallback(): (req: any, res: any) => void;
+    /**
+     * Handle fatal errors that occur outside the Kernel's management.
+     */
+    private handleFatalError;
     /**
      * Gracefully terminate the application.
      */
     terminate(): Promise<void>;
+    /**
+     * Register CLI commands with the application.
+     */
+    registerCommands(commands: any[]): void;
+    /**
+     * Get all registered commands.
+     */
+    getCommands(): any[];
     /**
      * Get the router instance.
      */

package/dist/Application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../src/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAS,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG7E,qBAAa,WAAY,SAAQ,qBAAsB,YAAW,mBAAmB;IACjF,WAAkB,OAAO,IAAI,MAAM,CAYlC;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IACvB,SAAS,CAAC,aAAa,EAAE,OAAO,CAAS;gBAE7B,QAAQ,GAAE,MAAsB;IAc/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIrC;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAItC;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAI9B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIvC;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIlC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAI1D;;OAEG;IACU,MAAM,CAAC,IAAI,GAAE,MAAa;IA4BvC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAgBpC;;OAEG;IACI,WAAW,KAmBN,KAAK,GAAG,EAAE,KAAK,GAAG;IAwB9B;;OAEG;IACU,SAAS;IAuDtB;;OAEG;IACI,SAAS,IAAI,MAAM;CAG7B"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../src/Application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAS,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG7E,qBAAa,WAAY,SAAQ,qBAAsB,YAAW,mBAAmB;IACjF,WAAkB,OAAO,IAAI,MAAM,CAYlC;IAED,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC;IACvB,SAAS,CAAC,aAAa,EAAE,OAAO,CAAS;IACzC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAM;gBAEpB,QAAQ,GAAE,MAAsB;IAc/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIrC;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAItC;;OAEG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAI9B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIvC;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIjC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAIlC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAI1D;;OAEG;IACU,MAAM,CAAC,IAAI,GAAE,MAAa;IA4BvC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAgBpC;;OAEG;IACI,WAAW,KAcN,KAAK,GAAG,EAAE,KAAK,GAAG;IA+B9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACU,SAAS;IAuDtB;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;IAIvC;;OAEG;IACI,WAAW,IAAI,GAAG,EAAE;IAI3B;;OAEG;IACI,SAAS,IAAI,MAAM;CAG7B"}

package/dist/Application.js

@@ -58,6 +58,7 @@ class Application extends foundation_1.Application {
     constructor(basePath = process.cwd()) {
         super(basePath);
         this.isTerminating = false;
+        this._commands = [];
         (0, helpers_1.setApp)(this);
         // Initialize Core Components
         this.router = new router_1.Router(this.getContainer());
@@ -158,32 +159,55 @@ class Application extends foundation_1.Application {
         const kernel = this.make(Kernel);
         const { ObjectPool } = require('@arikajs/foundation');
         const { Request: ArikaRequest, Response: ArikaResponse, RawResponse } = require('@arikajs/http');
-        const requestPool = new ObjectPool(() => new ArikaRequest(this, null), (obj) => obj.reset(null));
-        const responsePool = new ObjectPool(() => new ArikaResponse(null), (obj) => obj.reset(null));
+        const { Handler } = require('./http/Handler');
+        let handler;
+        try {
+            handler = this.make(Handler);
+        }
+        catch (e) {
+            handler = new Handler();
+        }
         return (req, res) => {
-            const request = requestPool.acquire();
-            const response = responsePool.acquire();
-            request.reset(req);
-            response.reset(res);
-            const handleRequest = async () => {
-                try {
-                    const finalResponse = await kernel.handle(request, response);
+            const request = new ArikaRequest(this, req);
+            const response = new ArikaResponse(res);
+            const handleError = (error) => {
+                handler.report(error);
+                Promise.resolve(handler.render(request, error, response))
+                    .then((finalResponse) => {
                     kernel.terminate(request, finalResponse);
+                })
+                    .catch((renderError) => {
+                    this.handleFatalError(res, renderError);
+                });
+            };
+            try {
+                const result = kernel.handle(request, response);
+                if (result instanceof Promise) {
+                    result.then((finalResponse) => {
+                        kernel.terminate(request, finalResponse);
+                    }).catch(handleError);
                 }
-                catch (error) {
-                    if (!res.headersSent) {
-                        res.writeHead(500, { 'Content-Type': 'application/json' });
-                        res.end(JSON.stringify({ error: 'Internal Server Error', message: error.message }));
-                    }
-                }
-                finally {
-                    requestPool.release(request);
-                    responsePool.release(response);
+                else {
+                    kernel.terminate(request, result);
                 }
-            };
-            handleRequest();
+            }
+            catch (error) {
+                handleError(error);
+            }
         };
     }
+    /**
+     * Handle fatal errors that occur outside the Kernel's management.
+     */
+    handleFatalError(res, error) {
+        if (!res.headersSent) {
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                error: 'Internal Server Error',
+                message: error.message || 'An unexpected error occurred'
+            }));
+        }
+    }
     /**
      * Gracefully terminate the application.
      */
@@ -235,6 +259,18 @@ class Application extends foundation_1.Application {
             }, 50);
         }
     }
+    /**
+     * Register CLI commands with the application.
+     */
+    registerCommands(commands) {
+        this._commands = [...this._commands, ...commands];
+    }
+    /**
+     * Get all registered commands.
+     */
+    getCommands() {
+        return this._commands;
+    }
     /**
      * Get the router instance.
      */