arikajs 0.10.3 → 0.10.4

package/package.json

@@ -1,42 +1,40 @@
 {
   "name": "arikajs",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "The ArikaJS Framework.",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc -p tsconfig.json && cp -R src/http/views dist/http/",
-    "clean": "rm -rf dist",
-    "test": "npx tsx tests/Framework.test.ts",
-    "dev": "tsc -p tsconfig.json --watch"
-  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "dependencies": {
-    "@arikajs/auth": "workspace:*",
-    "@arikajs/authorization": "workspace:*",
-    "@arikajs/cache": "workspace:*",
-    "@arikajs/carbon": "workspace:^",
-    "@arikajs/console": "workspace:*",
-    "@arikajs/database": "workspace:*",
-    "@arikajs/dispatcher": "workspace:*",
-    "@arikajs/encryption": "workspace:*",
-    "@arikajs/events": "workspace:*",
-    "@arikajs/foundation": "workspace:*",
-    "@arikajs/http": "workspace:*",
-    "@arikajs/localization": "workspace:*",
-    "@arikajs/logging": "workspace:*",
-    "@arikajs/mail": "workspace:*",
-    "@arikajs/middleware": "workspace:*",
-    "@arikajs/queue": "workspace:*",
-    "@arikajs/router": "workspace:*",
-    "@arikajs/scheduler": "workspace:*",
-    "@arikajs/session": "workspace:*",
-    "@arikajs/storage": "workspace:*",
-    "@arikajs/validation": "workspace:*",
-    "@arikajs/view": "workspace:*",
     "@types/serve-static": "^2.2.0",
     "busboy": "^1.6.0",
-    "serve-static": "^2.2.1"
+    "serve-static": "^2.2.1",
+    "@arikajs/carbon": "^0.10.4",
+    "@arikajs/auth": "0.10.4",
+    "@arikajs/dispatcher": "0.10.4",
+    "@arikajs/database": "0.10.4",
+    "@arikajs/encryption": "0.10.4",
+    "@arikajs/console": "0.10.4",
+    "@arikajs/events": "0.10.4",
+    "@arikajs/cache": "0.10.4",
+    "@arikajs/foundation": "0.10.4",
+    "@arikajs/authorization": "0.10.4",
+    "@arikajs/logging": "0.10.4",
+    "@arikajs/middleware": "0.10.4",
+    "@arikajs/queue": "0.10.4",
+    "@arikajs/router": "0.10.4",
+    "@arikajs/scheduler": "0.10.4",
+    "@arikajs/http": "0.10.4",
+    "@arikajs/session": "0.10.4",
+    "@arikajs/storage": "0.10.4",
+    "@arikajs/localization": "0.10.4",
+    "@arikajs/validation": "0.10.4",
+    "@arikajs/mail": "0.10.4",
+    "@arikajs/view": "0.10.4"
   },
   "devDependencies": {
     "@types/node": "^20.11.24",
@@ -52,5 +50,11 @@
   "bugs": {
     "url": "https://github.com/ArikaJs/arikajs/issues"
   },
-  "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/arikajs#readme"
-}
+  "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/arikajs#readme",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && cp -R src/http/views dist/http/",
+    "clean": "rm -rf dist",
+    "test": "npx tsx tests/Framework.test.ts",
+    "dev": "tsc -p tsconfig.json --watch"
+  }
+}

package/CHANGELOG.md

@@ -1,152 +0,0 @@
-# arikajs
-
-## 0.10.3
-
-### Patch Changes
-
-- Updated dependencies
-  - @arikajs/view@0.10.3
-  - @arikajs/auth@0.10.3
-  - @arikajs/authorization@0.10.3
-  - @arikajs/cache@0.10.3
-  - @arikajs/carbon@0.10.3
-  - @arikajs/console@0.10.3
-  - @arikajs/database@0.10.3
-  - @arikajs/dispatcher@0.10.3
-  - @arikajs/encryption@0.10.3
-  - @arikajs/events@0.10.3
-  - @arikajs/foundation@0.10.3
-  - @arikajs/http@0.10.3
-  - @arikajs/localization@0.10.3
-  - @arikajs/logging@0.10.3
-  - @arikajs/mail@0.10.3
-  - @arikajs/middleware@0.10.3
-  - @arikajs/queue@0.10.3
-  - @arikajs/router@0.10.3
-  - @arikajs/scheduler@0.10.3
-  - @arikajs/session@0.10.3
-  - @arikajs/storage@0.10.3
-  - @arikajs/validation@0.10.3
-
-## 0.0.8
-
-### Patch Changes
-
-- fix: ensure newly created projects automatically sync their framework version with the CLI version
-- Updated dependencies
-  - @arikajs/cli@0.0.8
-  - @arikajs/auth@0.0.8
-  - @arikajs/authorization@0.0.8
-  - @arikajs/cache@0.0.8
-  - @arikajs/console@0.0.8
-  - @arikajs/database@0.0.8
-  - @arikajs/dispatcher@0.0.8
-  - @arikajs/encryption@0.0.8
-  - @arikajs/events@0.0.8
-  - @arikajs/foundation@0.0.8
-  - @arikajs/http@0.0.8
-  - @arikajs/localization@0.0.8
-  - @arikajs/logging@0.0.8
-  - @arikajs/mail@0.0.8
-  - @arikajs/middleware@0.0.8
-  - @arikajs/queue@0.0.8
-  - @arikajs/router@0.0.8
-  - @arikajs/scheduler@0.0.8
-  - @arikajs/session@0.0.8
-  - @arikajs/storage@0.0.8
-  - @arikajs/validation@0.0.8
-  - @arikajs/view@0.0.8
-
-## 0.0.7
-
-### Patch Changes
-
-- fix: removed workspace: versioning from http package and ensured CLI templates use semantic versions by default
-- Updated dependencies
-  - @arikajs/cli@0.0.7
-  - @arikajs/http@0.0.7
-  - @arikajs/auth@0.0.7
-  - @arikajs/authorization@0.0.7
-  - @arikajs/cache@0.0.7
-  - @arikajs/console@0.0.7
-  - @arikajs/database@0.0.7
-  - @arikajs/dispatcher@0.0.7
-  - @arikajs/encryption@0.0.7
-  - @arikajs/events@0.0.7
-  - @arikajs/foundation@0.0.7
-  - @arikajs/localization@0.0.7
-  - @arikajs/logging@0.0.7
-  - @arikajs/mail@0.0.7
-  - @arikajs/middleware@0.0.7
-  - @arikajs/queue@0.0.7
-  - @arikajs/router@0.0.7
-  - @arikajs/scheduler@0.0.7
-  - @arikajs/session@0.0.7
-  - @arikajs/storage@0.0.7
-  - @arikajs/validation@0.0.7
-  - @arikajs/view@0.0.7
-
-## 0.0.6
-
-### Patch Changes
-
-- fix: ensure CLI templates use semantic version dependencies instead of local file paths when published to npm
-- Updated dependencies
-  - @arikajs/cli@0.0.6
-  - @arikajs/auth@0.0.6
-  - @arikajs/authorization@0.0.6
-  - @arikajs/cache@0.0.6
-  - @arikajs/console@0.0.6
-  - @arikajs/database@0.0.6
-  - @arikajs/dispatcher@0.0.6
-  - @arikajs/encryption@0.0.6
-  - @arikajs/events@0.0.6
-  - @arikajs/foundation@0.0.6
-  - @arikajs/http@0.0.6
-  - @arikajs/localization@0.0.6
-  - @arikajs/logging@0.0.6
-  - @arikajs/mail@0.0.6
-  - @arikajs/middleware@0.0.6
-  - @arikajs/queue@0.0.6
-  - @arikajs/router@0.0.6
-  - @arikajs/scheduler@0.0.6
-  - @arikajs/session@0.0.6
-  - @arikajs/storage@0.0.6
-  - @arikajs/validation@0.0.6
-  - @arikajs/view@0.0.6
-
-## 0.0.5
-
-### Patch Changes
-
-- feat: implement CSRF protection and standardized middleware architecture
-
-  - Added session-based CSRF protection middleware.
-  - Refactored middleware into project-level stubs for better customization.
-  - Standardized auth controller stubs.
-  - Enhanced CLI project scaffolding.
-  - Added session and localization packages.
-
-- Updated dependencies
-  - @arikajs/auth@0.0.5
-  - @arikajs/authorization@0.0.5
-  - @arikajs/cache@0.0.5
-  - @arikajs/cli@0.0.5
-  - @arikajs/console@0.0.5
-  - @arikajs/database@0.0.5
-  - @arikajs/dispatcher@0.0.5
-  - @arikajs/encryption@0.0.5
-  - @arikajs/events@0.0.5
-  - @arikajs/foundation@0.0.5
-  - @arikajs/http@0.0.5
-  - @arikajs/localization@0.0.5
-  - @arikajs/logging@0.0.5
-  - @arikajs/mail@0.0.5
-  - @arikajs/middleware@0.0.5
-  - @arikajs/queue@0.0.5
-  - @arikajs/router@0.0.5
-  - @arikajs/scheduler@0.0.5
-  - @arikajs/session@0.0.5
-  - @arikajs/storage@0.0.5
-  - @arikajs/validation@0.0.5
-  - @arikajs/view@0.0.5

package/src/Application.ts

@@ -1,248 +0,0 @@
-import { Application as FoundationApplication } from '@arikajs/foundation';
-import { Router, Route } from '@arikajs/router';
-import { FrameworkServiceProvider } from './providers/FrameworkServiceProvider';
-import { Log } from '@arikajs/logging';
-import { Application as ApplicationContract } from './Contracts/Application';
-import { setApp } from './helpers';
-
-export class Application extends FoundationApplication implements ApplicationContract {
-    public static get VERSION(): string {
-        try {
-            // Find the version from the local package.json
-            return require('../package.json').version;
-        } catch (e) {
-            try {
-                // Fallback if running in a different environment
-                return require('../../package.json').version;
-            } catch (e) {
-                return 'unknown';
-            }
-        }
-    }
-
-    protected router: Router;
-    protected server?: any;
-    protected isTerminating: boolean = false;
-
-    constructor(basePath: string = process.cwd()) {
-        super(basePath);
-        setApp(this);
-
-        // Initialize Core Components
-        this.router = new Router(this.getContainer());
-
-        // Register within container
-        this.instance(Router, this.router);
-
-        // Register Core Framework Provider
-        this.register(FrameworkServiceProvider);
-    }
-
-    public async boot(): Promise<void> {
-        if (this.isBooted()) return;
-        await super.boot();
-        (this.router as any).sync();
-    }
-
-    public version(): string {
-        return Application.VERSION;
-    }
-
-    /**
-     * Map a GET route.
-     */
-    public get(path: string, handler: any) {
-        return Route.get(path, handler);
-    }
-
-    /**
-     * Map a POST route.
-     */
-    public post(path: string, handler: any) {
-        return Route.post(path, handler);
-    }
-
-    /**
-     * Map a PUT route.
-     */
-    public put(path: string, handler: any) {
-        return Route.put(path, handler);
-    }
-
-    public patch(path: string, handler: any) {
-        return Route.patch(path, handler);
-    }
-
-    /**
-     * Map a DELETE route.
-     */
-    public delete(path: string, handler: any) {
-        return Route.delete(path, handler);
-    }
-
-    public options(path: string, handler: any) {
-        return Route.options(path, handler);
-    }
-
-    public match(methods: string[], path: string, handler: any) {
-        return Route.match(methods, path, handler);
-    }
-
-    /**
-     * Start the HTTP server.
-     */
-    public async listen(port: number = 3000) {
-        if (!this.isBooted()) {
-            await this.boot();
-        }
-
-        const http = await import('node:http');
-        const { Request, Response } = await import('@arikajs/http');
-        const { Kernel } = await import('./http/Kernel');
-
-        // Resolve Kernel from the container
-        const kernel = this.make(Kernel);
-        const callback = this.getCallback();
-
-        this.server = http.createServer(callback);
-
-        // Graceful shutdown
-        const shutdown = () => this.terminate();
-        process.on('SIGINT', shutdown);
-        process.on('SIGTERM', shutdown);
-
-        return new Promise<void>((resolve) => {
-            this.server.listen(port, () => {
-                this.displayBanner(port);
-                resolve();
-            });
-        });
-    }
-
-    protected displayBanner(port: number) {
-        const env = this.config().get('app.env', 'development');
-
-        console.log(`\x1b[38;5;99m
-     _         _ _              _ ____  
-    / \\   _ __(_) | ____ _     | / ___| 
-   / _ \\ | '__| | |/ / _\` |    | \\___ \\ 
-  / ___ \\| |  | |   < (_| |  __| |___) |
- /_/   \\_\\_|  |_|_|\\_\\__,_| |____|____/ 
-\x1b[0m`);
-        console.log(` \x1b[1mArikaJS Framework\x1b[0m \x1b[38;5;99mv${this.version()}\x1b[0m`);
-        console.log(` \x1b[90mEnvironment:\x1b[0m \x1b[33m${env}\x1b[0m`);
-        console.log(` \x1b[90mLocal URL:\x1b[0m   \x1b[36mhttp://localhost:${port}\x1b[0m`);
-        console.log('');
-    }
-
-    /**
-     * Get the HTTP server callback for raw http.createServer() usage.
-     */
-    public getCallback() {
-        if (!this.isBooted()) {
-            throw new Error('Application must be booted before calling getCallback()');
-        }
-
-        const { Kernel } = require('./http/Kernel');
-        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 as any)(this, null),
-            (obj: any) => obj.reset(null)
-        );
-        const responsePool = new ObjectPool(
-            () => new (ArikaResponse as any)(null),
-            (obj: any) => obj.reset(null)
-        );
-
-        return (req: any, res: any) => {
-            const request = requestPool.acquire();
-            const response = responsePool.acquire();
-            request.reset(req);
-            response.reset(res);
-
-            const handleRequest = async () => {
-                try {
-                    const finalResponse = await (kernel as any).handle(request, response);
-                    (kernel as any).terminate(request, finalResponse);
-                } catch (error: any) {
-                    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);
-                }
-            };
-            handleRequest();
-        };
-    }
-
-    /**
-     * Gracefully terminate the application.
-     */
-    public async terminate() {
-        if (this.isTerminating) return;
-        this.isTerminating = true;
-
-        if (this.server) {
-            // Close all active connections to speed up shutdown (Node 18.2+)
-            if (typeof this.server.closeAllConnections === 'function') {
-                this.server.closeAllConnections();
-            }
-
-            // Force close idle connections
-            if (typeof this.server.closeIdleConnections === 'function') {
-                this.server.closeIdleConnections();
-            }
-
-            await new Promise<void>((resolve) => {
-                // Set a timeout to force resolve if server doesn't close in time
-                const timeout = setTimeout(() => {
-                    Log.warning('HTTP server forced to close due to timeout.');
-                    resolve();
-                }, 1000);
-
-                this.server.close(() => {
-                    clearTimeout(timeout);
-                    Log.info('HTTP server closed.');
-                    resolve();
-                });
-            });
-        }
-
-        // Close database connections
-        if (this.has('db')) {
-            try {
-                const db = this.make<any>('db');
-                if (typeof db.closeAll === 'function') {
-                    await db.closeAll();
-                }
-            } catch (e) { }
-        }
-
-        // Potential for other service termination (Queues, etc.)
-
-        // Remove signal listeners to prevent double triggers during exit
-        process.removeAllListeners('SIGINT');
-        process.removeAllListeners('SIGTERM');
-
-        // If we are in a testing or specific environment, we might not want to exit
-        if (process.env.NODE_ENV !== 'test') {
-            // Give a short delay for logs to flush before exiting
-            setTimeout(() => {
-                process.exit(0);
-            }, 50);
-        }
-    }
-
-    /**
-     * Get the router instance.
-     */
-    public getRouter(): Router {
-        return this.router;
-    }
-}

package/src/Contracts/Application.ts

@@ -1,24 +0,0 @@
-
-import { Router } from '@arikajs/router';
-import { Application as HttpApplicationContract } from '@arikajs/http';
-
-export interface Application extends HttpApplicationContract {
-    getRouter(): Router;
-    getContainer(): any;
-    getBasePath(): string;
-    make<T = any>(token: any): T;
-    singleton<T = any>(token: any, factory: any): void;
-    instance<T = any>(token: any, value: T): void;
-    bind<T = any>(token: any, factory: any): void;
-    resolve<T = any>(token: any): T;
-    has(token: any): boolean;
-    alias(token: any, alias: any): void;
-    tag(token: any, tag: string): void;
-    tagged<T = any>(tag: string): T[];
-    extend<T = any>(token: any, callback: (instance: T) => T): void;
-    register(provider: any): void;
-    boot(): Promise<void>;
-    run(): Promise<void>;
-    terminate(): Promise<void>;
-    isBooted(): boolean;
-}

package/src/createApp.ts

@@ -1,9 +0,0 @@
-
-import { Application } from './Application';
-
-/**
- * Helper to create a new ArikaJS application instance.
- */
-export function createApp(basePath?: string): Application {
-    return new Application(basePath);
-}

package/src/facades/Schedule.ts

@@ -1,26 +0,0 @@
-import { app } from '../helpers.js';
-import { Scheduler, Schedule as BaseSchedule } from '@arikajs/scheduler';
-
-/**
- * The amazing Laravel-like static Schedule Facade.
- * This completely eliminates the need for developers to manually resolve
- * the Scheduler from the container or wrap their events in `.define()`!
- */
-export const Schedule = new Proxy({} as BaseSchedule, {
-    get(target, prop) {
-        // Automatically inject and resolve the underlying Scheduler singleton on demand
-        const scheduler = app().make(Scheduler) as Scheduler;
-        
-        // Expose the raw schedule builder instance
-        const underlyingSchedule = (scheduler as any).schedule as BaseSchedule;
-        
-        const value = (underlyingSchedule as any)[prop];
-        
-        // If it's a builder method (like .call() or .command()), bind it perfectly
-        if (typeof value === 'function') {
-            return value.bind(underlyingSchedule);
-        }
-        
-        return value;
-    }
-});

package/src/helpers.ts

@@ -1,150 +0,0 @@
-
-import { Application } from './Application';
-import { Route } from '@arikajs/router';
-import { Log } from '@arikajs/logging';
-import { Translator } from '@arikajs/localization';
-import { env as configEnv } from '@arikajs/config';
-import { carbon as carbonFactory } from '@arikajs/carbon';
-
-/**
- * Get the application instance.
- */
-let appInstance: Application | null = null;
-
-export function setApp(app: Application) {
-    appInstance = app;
-}
-
-export function app(): Application {
-    if (!appInstance) {
-        throw new Error('Application instance not set.');
-    }
-    return appInstance;
-}
-
-/**
- * Get a configuration value.
- */
-export function config<T = any>(key?: string, defaultValue: T = null as any): T {
-    const repository = app().config();
-    if (!key) return repository as any;
-    return repository.get(key, defaultValue);
-}
-
-/**
- * Get an environment variable.
- */
-export function env<T = any>(key: string, defaultValue?: T): T {
-    return configEnv(key, defaultValue);
-}
-
-/**
- * Log an info message.
- */
-export function info(message: string, context: any = {}) {
-    Log.info(message, context);
-}
-
-/**
- * Log an error message.
- */
-export function error(message: string, context: any = {}) {
-    Log.error(message, context);
-}
-
-/**
- * Log a warning message.
- */
-export function warning(message: string, context: any = {}) {
-    Log.warning(message, context);
-}
-
-/**
- * Log a debug message.
- */
-export function debug(message: string, context: any = {}) {
-    Log.debug(message, context);
-}
-
-/**
- * Generate a URL for a named route.
- */
-export function route(name: string, params: any = {}): string {
-    return app().getRouter().route(name, params);
-}
-
-/**
- * Translate the given message.
- */
-export function lang(key: string, replace: Record<string, any> = {}, locale: string | null = null): string {
-    return (app().make(Translator) as Translator).get(key, replace, locale);
-}
-
-// Alias for common patterns
-export const trans = lang;
-export const __ = lang;
-
-/**
- * Get the current request instance.
- */
-export function request(): any {
-    return (app() as any).currentRequest;
-}
-
-/**
- * Get the current auth context or manager.
- */
-export function auth(): any {
-    const req = request();
-    if (req && req.auth) {
-        return req.auth;
-    }
-    return app().make('auth');
-}
-
-/**
- * Render a view template or get the view engine.
- */
-export async function view(template?: string, data: any = {}): Promise<any> {
-    const req = request();
-
-    // 1. If we are in a request context and req.view.render exists, use it!
-    // This is the preferred way as it handles session errors, CSRF, etc. correctly
-    if (req && req.view && typeof req.view.render === 'function') {
-        if (template === undefined) return req.view;
-        return await req.view.render(template, data);
-    }
-
-    // 2. Fallback to global view engine
-    const engine = app().make('view') as any;
-    if (template === undefined) return engine;
-
-    return await engine.render(template, data);
-}
-
-/**
- * Create a new Carbon instance for date manipulation.
- */
-export function carbon(date?: any): any {
-    return carbonFactory(date);
-}
-
-/**
- * Format the given date.
- */
-export function date(date?: any, format = 'Y-m-d'): string {
-    return carbon(date).format(format);
-}
-
-// Add properties to support view.render() and view.share() as seen in the README
-view.render = (template: string, data: any = {}) => {
-    return (app().make('view') as any).render(template, data);
-};
-
-view.share = (key: string, value: any) => {
-    return (app().make('view') as any).share(key, value);
-};
-
-view.composer = (template: string, callback: any) => {
-    return (app().make('view') as any).composer(template, callback);
-};