arikajs 0.10.2 → 0.10.4

package/CHANGELOG.md

@@ -1,124 +0,0 @@
-# arikajs
-
-## 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,236 +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 readonly VERSION = '0.0.5';
-
-    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/helpers.ts

@@ -1,106 +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';
-
-/**
- * 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;
-
-/**
- * Render a view template or get the view engine.
- */
-export function view(template?: string, data: any = {}): any {
-    const engine = app().make('view') as any;
-    if (template === undefined) return engine;
-    return engine.render(template, data);
-}
-
-// 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);
-};

package/src/http/Handler.ts

@@ -1,184 +0,0 @@
-
-import { Request, Response, HttpException } from '@arikajs/http';
-import { Log } from '@arikajs/logging';
-
-export class Handler {
-    /**
-     * A list of the exception types that should not be reported.
-     */
-    protected dontReport: any[] = [];
-
-    /**
-     * Custom renderers for specific exception types.
-     */
-    protected renderers: Map<any, (request: Request, error: any, response: Response) => Response> = new Map();
-
-    /**
-     * Report or log an exception.
-     */
-    public report(error: any): void {
-        if (this.shouldReport(error)) {
-            Log.error(error.message || 'Error', {
-                stack: error.stack,
-                name: error.name || 'Error',
-                originalError: error.originalError
-            });
-        }
-    }
-
-    /**
-     * Render an exception into an HTTP response.
-     */
-    public async render(request: Request, error: any, response: Response): Promise<Response> {
-        // 1. Check if the error has a custom renderer
-        for (const [type, renderer] of this.renderers.entries()) {
-            if (error instanceof type) {
-                return renderer(request, error, response);
-            }
-        }
-
-        // 2. Check if the error is "renderable" (has a render method)
-        if (typeof error.render === 'function') {
-            return error.render(request, response);
-        }
-
-        // 3. Handle HttpException specifically
-        if (error instanceof HttpException) {
-            const status = error.getStatusCode();
-            const isBrowserRequest = this.isBrowserRequest(request);
-
-            if (isBrowserRequest) {
-                return this.renderForBrowser(request, status, error, response);
-            }
-
-            return response.status(status).json({
-                error: true,
-                message: error.message,
-                ...(this.shouldDisplayStackTrace() ? { trace: error.stack } : {})
-            });
-        }
-
-        // 4. Default error handling
-        const status = error.statusCode || error.status || 500;
-        const message = status === 500 && !this.shouldDisplayStackTrace()
-            ? 'Internal Server Error'
-            : error.message || 'Unknown Error';
-
-        const isBrowserRequest = this.isBrowserRequest(request);
-        if (isBrowserRequest) {
-            return this.renderForBrowser(request, status, error, response);
-        }
-
-        return response.status(status).json({
-            error: true,
-            message: message,
-            ...(this.shouldDisplayStackTrace() ? {
-                name: error.name,
-                trace: error.stack
-            } : {})
-        });
-    }
-
-    /**
-     * Determine if the exception should be reported.
-     */
-    protected shouldReport(error: any): boolean {
-        return !this.dontReport.some(type => error instanceof type);
-    }
-
-    /**
-     * Determine if the stack trace should be displayed.
-     */
-    protected shouldDisplayStackTrace(): boolean {
-        return process.env.NODE_ENV === 'development' || process.env.APP_DEBUG === 'true';
-    }
-
-    /**
-     * Determine if the incoming request is a browser (non-API, non-JSON) request.
-     */
-    protected isBrowserRequest(request: Request): boolean {
-        if (!request || typeof request.path !== 'function') return false;
-        if (request.path().startsWith('/api')) return false;
-        const accept = (request.header('accept') as string) || '';
-        if (accept.includes('application/json') && !accept.includes('text/html')) return false;
-        return true;
-    }
-
-    /**
-     * Render an error response for browser (HTML) clients.
-     * Override in the application Handler to show custom error views.
-     */
-    protected async renderForBrowser(request: Request, status: number, error: any, response: Response): Promise<Response> {
-        const supportedErrors = [401, 403, 404, 419, 429, 500, 503];
-
-        if (supportedErrors.includes(status)) {
-            const fs = await import('fs');
-            const path = await import('path');
-            const appName = process.env.APP_NAME || 'ArikaJS';
-
-            const renderFile = async (filePath: string): Promise<string | null> => {
-                try {
-                    let html = await fs.promises.readFile(filePath, 'utf8');
-                    html = html.replace(/\{\{app_name\}\}/g, appName);
-                    // Also replace ArkJS template config() calls
-                    html = html.replace(/\{\{\s*config\('app\.name'[^)]*\)\s*\}\}/g, appName);
-                    return html;
-                } catch { return null; }
-            };
-
-            // 1. App override: resources/views/errors/{status}.ark.html
-            const root = process.env.PROJECT_ROOT || process.cwd();
-            const appView = path.join(root, 'resources', 'views', 'errors', `${status}.ark.html`);
-            const appHtml = await renderFile(appView);
-            if (appHtml) return response.status(status).send(appHtml);
-
-            // 2. Framework bundled views (packages/arikajs/src/http/views/errors/)
-            const frameworkView = path.join(__dirname, 'views', 'errors', `${status}.ark.html`);
-            const frameworkHtml = await renderFile(frameworkView);
-            if (frameworkHtml) return response.status(status).send(frameworkHtml);
-
-            // 3. Also try dist path (when running from compiled JS)
-            const frameworkViewDist = path.join(__dirname, '..', '..', 'src', 'http', 'views', 'errors', `${status}.ark.html`);
-            const frameworkHtmlDist = await renderFile(frameworkViewDist);
-            if (frameworkHtmlDist) return response.status(status).send(frameworkHtmlDist);
-        }
-
-        return response.status(status).send(
-            `<!DOCTYPE html><html><head><title>${status} Error</title></head><body style="font-family:sans-serif;text-align:center;padding:4rem"><h1 style="font-size:4rem;color:#8b5cf6">${status}</h1><p style="color:#64748b">${error.message || 'An error occurred'}</p><a href="/" style="color:#8b5cf6">Return Home</a></body></html>`
-        );
-    }
-
-
-    /**
-     * Set the exceptions that should not be reported.
-     */
-    public dontReportExceptions(exceptions: any[]): this {
-        this.dontReport = [...this.dontReport, ...exceptions];
-        return this;
-    }
-
-    /**
-     * Map an exception to a custom renderer.
-     */
-    public map(type: any, renderer: (request: Request, error: any, response: Response) => Response): this {
-        this.renderers.set(type, renderer);
-        return this;
-    }
-
-    /**
-     * Register a custom renderer for an exception type.
-     */
-    public renderable(type: any, renderer: (request: Request, error: any, response: Response) => Response): this {
-        return this.map(type, renderer);
-    }
-
-    /**
-     * Add an exception type to the dontReport list.
-     */
-    public ignore(type: any): this {
-        if (!this.dontReport.includes(type)) {
-            this.dontReport.push(type);
-        }
-        return this;
-    }
-}