@arikajs/cli 0.0.3 → 0.0.5

package/dist/templates/app/routes/api.ts

@@ -0,0 +1,39 @@
+import { Route, Request, Response, app } from 'arikajs';
+import { UserController } from '@Controllers/UserController';
+
+Route.get('/', () => {
+    return {
+        framework: 'ArikaJS',
+        version: app().version(),
+        type: 'Fullstack',
+        language: 'TypeScript',
+        status: 'Online',
+        message: 'Welcome to your premium ArikaJS Fullstack Application',
+        links: {
+            docs: 'https://github.com/arikajs/arikajs#readme',
+            github: 'https://github.com/arikajs/arikajs'
+        }
+    };
+});
+
+Route.get('/status', () => {
+    return {
+        status: 'UP',
+        uptime: process.uptime(),
+        timestamp: new Date().toISOString()
+    };
+});
+
+// Users CRUD Routes
+const userController = new UserController();
+
+Route.get('/users', userController.index);
+Route.get('/users/:id', userController.show);
+Route.post('/users', userController.store);
+Route.put('/users/:id', userController.update);
+Route.delete('/users/:id', userController.destroy);
+
+// Example of a protected API route
+// Route.get('/me', (req: Request, res: Response) => {
+//     return req.auth.user();
+// }).withMiddleware('auth:api');

package/dist/templates/app/routes/web.ts

@@ -0,0 +1,10 @@
+import { Route, Request, Response, view } from 'arikajs';
+
+Route.get('/', (req: Request, res: Response) => {
+    return view('welcome', { name: 'ArikaApp' });
+});
+
+// Example of a protected route
+// Route.get('/dashboard', (req: Request, res: Response) => {
+//     return view('dashboard');
+// }).withMiddleware('auth');

package/dist/templates/app/server.ts

@@ -0,0 +1,15 @@
+import app from './bootstrap/app';
+import { Log, config } from 'arikajs';
+
+const start = async () => {
+    // Start the application
+    console.log('🚀 Starting ArikaJS application...');
+
+    const port = config('http.port', 3000);
+
+    await app.listen(port);
+};
+
+start().catch((err) => {
+    console.error('Failed to start application:', err);
+});

package/dist/templates/app/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        "target": "ESNext",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "baseUrl": ".",
+        "paths": {
+            "@/*": ["app/*"],
+            "@Models/*": ["app/Models/*"],
+            "@Mail/*": ["app/Mail/*"],
+            "@Controllers/*": ["app/Http/Controllers/*"],
+            "@Middleware/*": ["app/Http/Middleware/*"],
+            "@Http/*": ["app/Http/*"],
+            "@Exceptions/*": ["app/Exceptions/*"],
+            "@Providers/*": ["app/Providers/*"],
+            "@Config/*": ["config/*"]
+        },
+        "outDir": "./dist",
+        "rootDir": "./",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "experimentalDecorators": true,
+        "emitDecoratorMetadata": true
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arikajs/cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "The command-line interface for the ArikaJS framework.",
   "license": "MIT",
   "main": "dist/index.js",
@@ -9,12 +9,13 @@
     "arika": "dist/bin/arika.js"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && chmod +x dist/bin/arika.js",
+    "build": "tsc -p tsconfig.json && cp -R templates dist/ && chmod +x dist/bin/arika.js",
     "build:tests": "tsc -p tsconfig.test.json",
     "clean": "rm -rf dist",
     "prepare": "echo skip",
     "test": "npm run build && npm run build:tests && node --test 'dist/tests/**/*.test.js'",
-    "test:watch": "npm run build && npm run build:tests && node --test --watch 'dist/tests/**/*.test.js'"
+    "test:watch": "npm run build && npm run build:tests && node --test --watch 'dist/tests/**/*.test.js'",
+    "dev": "tsc -p tsconfig.json --watch"
   },
   "files": [
     "dist",
@@ -32,18 +33,23 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/arikajs/cli.git"
+    "url": "git+https://github.com/ArikaJs/arikajs.git",
+    "directory": "packages/cli"
   },
   "bugs": {
-    "url": "https://github.com/arikajs/cli/issues"
+    "url": "https://github.com/ArikaJs/arikajs/issues"
   },
-  "homepage": "https://github.com/arikajs/cli#readme",
+  "homepage": "https://github.com/ArikaJs/arikajs/tree/main/packages/cli#readme",
   "dependencies": {
-    "@arikajs/console": "file:../console",
-    "@arikajs/database": "file:../database",
-    "@arikajs/docs": "file:../docs",
+    "@arikajs/console": "*",
+    "@arikajs/database": "*",
+    "@arikajs/docs": "*",
+    "@arikajs/scheduler": "*",
+    "dotenv": "^16.4.5",
     "inquirer": "^8.2.7",
-    "dotenv": "^16.4.5"
+    "ts-node": "^10.9.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.3"
   },
   "devDependencies": {
     "@types/dotenv": "^8.2.3",

package/templates/app/.env.example

@@ -1,4 +1,4 @@
-APP_NAME=ArikaApp
+APP_NAME=ArikaJs
 APP_ENV=development
 APP_PORT=3000
 APP_DEBUG=true
@@ -43,5 +43,5 @@ LOG_LEVEL=debug
 
 QUEUE_CONNECTION=sync
 
-CACHE_STORE=database
+CACHE_STORE=file
 CACHE_PREFIX=arika_cache

package/templates/app/README.md

@@ -0,0 +1,62 @@
+# ArikaJS Application
+
+Welcome to your new **ArikaJS** application! This project was generated with the ArikaJS CLI, providing you with a premium, type-safe, and high-performance foundation for your next web application or API.
+
+## 🚀 Getting Started
+
+### 1. Install Dependencies
+
+```bash
+npm install
+```
+
+### 2. Configure Environment
+
+Copy the `.env.example` file to `.env` and set your configuration value (like `APP_KEY` and database credentials).
+
+```bash
+cp .env.example .env
+```
+
+### 3. Generate Application Key
+
+```bash
+npx arika key:generate
+```
+
+### 4. Start Development Server
+
+```bash
+npm run dev
+```
+
+Your application will be running at `http://localhost:3000` 🎉
+
+## 🏗 Project Structure
+
+- `app/`: Contains your application logic (Controllers, Models, Middleware).
+- `bootstrap/`: Application bootstrapping and service provider registration.
+- `config/`: Configuration files for various system components.
+- `database/`: Migrations and seeders.
+- `public/`: Static assets (images, CSS, JS).
+- `resources/`: Views and templates.
+- `routes/`: Route definitions for Web and API.
+- `server.ts`: The entry point for the application.
+
+## 📚 Features
+
+- **Eloquent-style ORM**: Simple and powerful database interactions.
+- **Native Validation**: Easy request validation directly in your controllers.
+- **Service Container**: Robust dependency injection and service management.
+- **Middleware Pipeline**: Flexible request/response processing.
+- **Templating Engine**: Fast and intuitive HTML rendering.
+
+## 🤝 Community & Support
+
+- [GitHub Repository](https://github.com/arikajs/arikajs)
+- [Documentation](https://github.com/arikajs/arikajs#readme)
+- [Issue Tracker](https://github.com/arikajs/arikajs/issues)
+
+---
+
+**Built with ❤️ by the ArikaJS Team**

package/templates/app/app/Exceptions/Handler.ts

@@ -0,0 +1,19 @@
+import { Handler as BaseHandler } from 'arikajs';
+
+export class Handler extends BaseHandler {
+    /**
+     * Report or log an exception.
+     */
+    public report(error: any): void {
+        super.report(error);
+    }
+
+    /**
+     * Register the exception handling callbacks for the application.
+     */
+    public register(): void {
+        //
+    }
+}
+
+

package/templates/app/app/Http/Controllers/UserController.ts

@@ -0,0 +1,90 @@
+import { Request, Response } from 'arikajs';
+import { User } from '@Models/User';
+
+export class UserController {
+    /**
+     * Display a listing of the resource.
+     */
+    async index(req: Request, res: Response) {
+        const users = await User.all();
+        return res.json({ 
+            message: 'List of all users',
+            data: users 
+        });
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    async show(req: Request, res: Response) {
+        const id = req.param('id');
+        const user = await User.find(id);
+
+        if (!user) {
+            return res.status(404).json({ message: 'User not found' });
+        }
+
+        return res.json({ 
+            message: 'User details',
+            data: user 
+        });
+    }
+
+    /**
+     * Store a newly created resource.
+     */
+    async store(req: Request, res: Response) {
+        const data = await req.validate({
+            name: 'required|string|max:255',
+            email: 'required|email|unique:users',
+            password: 'required|string|min:8',
+        });
+
+        const user = await User.create(data);
+
+        return res.status(201).json({ 
+            message: 'User created successfully',
+            data: user 
+        });
+    }
+
+    /**
+     * Update the specified resource.
+     */
+    async update(req: Request, res: Response) {
+        const id = req.param('id');
+        const user = await User.find(id);
+
+        if (!user) {
+            return res.status(404).json({ message: 'User not found' });
+        }
+
+        const data = await req.validate({
+            name: 'string|max:255',
+            email: `email|unique:users,email,${id}`,
+        });
+
+        await user.update(data);
+
+        return res.json({ 
+            message: 'User updated successfully',
+            data: user 
+        });
+    }
+
+    /**
+     * Remove the specified resource.
+     */
+    async destroy(req: Request, res: Response) {
+        const id = req.param('id');
+        const user = await User.find(id);
+
+        if (!user) {
+            return res.status(404).json({ message: 'User not found' });
+        }
+
+        await user.delete();
+
+        return res.json({ message: 'User deleted successfully' });
+    }
+}

package/templates/app/app/Http/Kernel.ts

@@ -1,18 +1,43 @@
-import { Kernel as BaseKernel } from 'arikajs';
+import { Kernel as BaseKernel, StartSession, ViewMiddleware } from 'arikajs';
+import { Authenticate } from '@Middleware/Authenticate';
+import { RedirectIfAuthenticated } from '@Middleware/RedirectIfAuthenticated';
+import { EnsureEmailIsVerified } from '@Middleware/EnsureEmailIsVerified';
+import { VerifyCsrfToken } from '@Middleware/VerifyCsrfToken';
+import { TrimStrings } from '@Middleware/TrimStrings';
+import { TrustProxies } from '@Middleware/TrustProxies';
 
 export class Kernel extends BaseKernel {
-    /**
-     * The application's route middleware groups.
-     */
-    protected middlewareGroups = {
-        web: [],
-        api: [],
-    };
+    constructor(app: any) {
+        super(app);
 
-    /**
-     * The application's route middleware aliases.
-     */
-    protected routeMiddleware = {
-        'auth': (request: any, next: any) => next(request), // dummy for now
-    };
+        // Global middleware — runs on EVERY request (web + API).
+        this.middleware.push(
+            new TrustProxies(),
+            new TrimStrings(),
+        );
+
+        // Middleware groups — 'web' and 'api' groups.
+        Object.assign(this.middlewareGroups, {
+            web: [
+                StartSession,
+                ViewMiddleware,
+                new VerifyCsrfToken(),
+            ],
+            api: [
+                'throttle:120,60',
+            ],
+        });
+
+        // Named route middleware — aliases.
+        Object.assign(this.routeMiddleware, {
+            'auth': Authenticate,
+            'guest': RedirectIfAuthenticated,
+            'verified': EnsureEmailIsVerified,
+        });
+
+        // Sync with router
+        const router = this.app.getRouter();
+        router.setMiddlewareGroups(this.middlewareGroups);
+        router.setRouteMiddleware(this.routeMiddleware);
+    }
 }

package/templates/app/app/Http/Middleware/Authenticate.ts

@@ -0,0 +1,10 @@
+import { Authenticate as Middleware, Request } from 'arikajs';
+
+export class Authenticate extends Middleware {
+    /**
+     * Get the path the user should be redirected to when they are not authenticated.
+     */
+    protected redirectTo(request: Request): string | null {
+        return request.expectsJson() ? null : '/auth/login';
+    }
+}

package/templates/app/app/Http/Middleware/EnsureEmailIsVerified.ts

@@ -0,0 +1,18 @@
+import { Request, Response, Middleware } from 'arikajs';
+
+export class EnsureEmailIsVerified implements Middleware {
+    /**
+     * Handle an incoming request.
+     */
+    public async handle(request: Request, next: (request: Request) => Promise<Response>): Promise<Response> {
+        const user = await request.auth.user();
+
+        if (!user || (typeof user.hasVerifiedEmail === 'function' && !user.hasVerifiedEmail())) {
+            return request.expectsJson()
+                ? (request as any).res.json({ message: 'Your email address is not verified.' }, 403)
+                : (request as any).res.redirect('/auth/verify');
+        }
+
+        return await next(request);
+    }
+}

package/templates/app/app/Http/Middleware/ExampleMiddleware.ts

@@ -0,0 +1,12 @@
+import { Request, Response } from 'arikajs';
+
+export class ExampleMiddleware {
+    /**
+     * Handle an incoming request.
+     */
+    public async handle(request: Request, next: (req: Request) => Promise<Response>): Promise<Response> {
+        // Perform some action...
+
+        return await next(request);
+    }
+}

package/templates/app/app/Http/Middleware/RedirectIfAuthenticated.ts

@@ -0,0 +1,18 @@
+import { Request, Response } from 'arikajs';
+
+export class RedirectIfAuthenticated {
+    /**
+     * Handle an incoming request.
+     */
+    public async handle(request: Request, next: (request: Request) => Promise<Response>, ...guards: string[]): Promise<Response> {
+        const authGuards = guards.length > 0 ? guards : [undefined];
+
+        for (const guard of authGuards) {
+            if (await request.auth.guard(guard).check()) {
+                return (request as any).res.redirect('/dashboard');
+            }
+        }
+
+        return await next(request);
+    }
+}

package/templates/app/app/Http/Middleware/TrimStrings.ts

@@ -0,0 +1,12 @@
+import { TrimStrings as Middleware } from 'arikajs';
+
+export class TrimStrings extends Middleware {
+    /**
+     * The names of the attributes that should not be trimmed.
+     */
+    protected except: string[] = [
+        'current_password',
+        'password',
+        'password_confirmation',
+    ];
+}

package/templates/app/app/Http/Middleware/TrustProxies.ts

@@ -0,0 +1,23 @@
+import { Request, Response, Middleware } from 'arikajs';
+
+export class TrustProxies implements Middleware {
+    /**
+     * The trusted proxies for the application.
+     * Use '*' to trust all proxies, or an array of IP addresses.
+     */
+    protected proxies: string | string[] = '*';
+
+    /**
+     * The proxy header mappings.
+     */
+    protected headers: string = 'X-Forwarded-For | X-Forwarded-Host | X-Forwarded-Proto';
+
+    /**
+     * Handle an incoming request.
+     */
+    public async handle(request: Request, next: (request: Request) => Promise<Response>): Promise<Response> {
+        // In ArikaJS, proxy trust is currently configured in the config/http.ts file,
+        // but this middleware can be used to dynamically set trust logic if needed.
+        return await next(request);
+    }
+}

package/templates/app/app/Http/Middleware/VerifyCsrfToken.ts

@@ -0,0 +1,10 @@
+import { VerifyCsrfToken as Middleware } from 'arikajs';
+
+export class VerifyCsrfToken extends Middleware {
+    /**
+     * The URIs that should be excluded from CSRF verification.
+     */
+    protected except: string[] = [
+        //
+    ];
+}

package/templates/app/app/Models/User.ts

@@ -1,15 +1,15 @@
 import { Model } from 'arikajs';
 
 export class User extends Model {
-    static table = 'users';
+    protected static table = 'users';
 
-    static fillable = [
+    protected fillable: string[] = [
         'name',
         'email',
-        'password'
+        'password',
     ];
 
-    static hidden = [
-        'password'
+    protected hidden: string[] = [
+        'password',
     ];
 }

package/templates/app/app/Providers/AppServiceProvider.ts

@@ -0,0 +1,17 @@
+import { ServiceProvider } from 'arikajs';
+
+export class AppServiceProvider extends ServiceProvider {
+    /**
+     * Register any application services.
+     */
+    public register(): void {
+        // 
+    }
+
+    /**
+     * Bootstrap any application services.
+     */
+    public boot(): void {
+        // 
+    }
+}

package/templates/app/app/Providers/RouteServiceProvider.ts

@@ -0,0 +1,35 @@
+import { ServiceProvider, Route } from 'arikajs';
+import path from 'path';
+
+export class RouteServiceProvider extends ServiceProvider {
+    /**
+     * Register any application services.
+     */
+    public register(): void {
+        // 
+    }
+
+    /**
+     * Bootstrap any application services.
+     */
+    public boot(): void {
+        this.loadRoutes();
+    }
+
+    /**
+     * Load the application routes.
+     */
+    protected loadRoutes(): void {
+        const basePath = (this.app as any).getBasePath();
+
+        // 1. Load web routes (with session, CSRF, etc.)
+        Route.middleware('web').group(() => {
+            require(path.join(basePath, 'routes/web'));
+        });
+
+        // 2. Load API routes with /api prefix (stateless, auth via JWT)
+        Route.middleware('api').prefix('api').group(() => {
+            require(path.join(basePath, 'routes/api'));
+        });
+    }
+}

package/templates/app/bootstrap/app.ts

@@ -5,9 +5,37 @@ const app = createApp(
     path.resolve(__dirname, '../')
 );
 
-import { Kernel } from '../app/Http/Kernel';
-import { Kernel as BaseKernel } from 'arikajs';
+/*
+|--------------------------------------------------------------------------
+| Register Service Providers
+|--------------------------------------------------------------------------
+|
+| The service providers listed here will be automatically loaded on the
+| request to your application. Feel free to add your own services.
+|
+*/
+
+import { AppServiceProvider } from '@Providers/AppServiceProvider';
+import { RouteServiceProvider } from '@Providers/RouteServiceProvider';
+
+app.register(AppServiceProvider);
+app.register(RouteServiceProvider);
+
+/*
+|--------------------------------------------------------------------------
+| Register The Http Kernel
+|--------------------------------------------------------------------------
+|
+| Next, we need to bind the Http Kernel to the container so that it
+| can be resolved when handling requests.
+|
+*/
+
+import { Kernel } from '@Http/Kernel';
+import { Handler } from '@Exceptions/Handler';
+import { Kernel as BaseKernel, Handler as BaseHandler } from 'arikajs';
 
 app.singleton(BaseKernel, () => new Kernel(app));
+app.singleton(BaseHandler, () => new Handler());
 
 export default app;

package/templates/app/config/app.ts

@@ -1,9 +1,10 @@
+import { env } from 'arikajs';
 
 export default {
-    name: process.env.APP_NAME || 'ArikaJS',
-    env: process.env.APP_ENV || 'production',
-    debug: process.env.APP_DEBUG === 'true',
-    url: process.env.APP_URL || 'http://localhost',
-    timezone: process.env.APP_TIMEZONE || 'UTC',
-    key: process.env.APP_KEY,
+    name: env('APP_NAME', 'ArikaJS'),
+    env: env('APP_ENV', 'production'),
+    debug: env('APP_DEBUG', false), // env() handles boolean strings if we want, but let's check.
+    url: env('APP_URL', 'http://localhost'),
+    timezone: env('APP_TIMEZONE', 'UTC'),
+    key: env('APP_KEY'),
 };