arcanajs 3.0.1 → 5.0.0

package/dist/lib/server/Router.d.ts

@@ -1,60 +1,57 @@
-import express, { Router as ExpressRouter, RequestHandler } from "express";
+import { Router as ExpressRouter } from "express";
 /**
- * Provides Routing syntax for defining routes with prefixes, middlewares, and groups
+ * Provides Routing syntax for defining routes with prefixes, middlewares, and groups for ArcanaJS Framework
  */
-export declare class Router {
+export declare class ArcanaJSRouter {
     private router;
     private middlewareStack;
     private prefixStack;
     constructor();
-    /**
-     * Create a new router instance
-     */
-    static create(): Router;
     /**
      * Add middleware to the current stack
      */
-    middleware(...middleware: RequestHandler[]): Router;
+    middleware(...middleware: any[]): ArcanaJSRouter;
     /**
      * Add prefix to the current stack
      */
-    prefix(prefix: string): Router;
+    prefix(prefix: string): ArcanaJSRouter;
     /**
      * Create a route group
      */
-    group(callback: (router: Router) => void): Router;
+    group(callback: (router: ArcanaJSRouter) => void): ArcanaJSRouter;
     /**
      * Define a GET route
      */
-    get(path: string, ...args: any[]): Router;
+    get(path: string, ...args: any[]): ArcanaJSRouter;
     /**
      * Define a POST route
      */
-    post(path: string, ...args: any[]): Router;
+    post(path: string, ...args: any[]): ArcanaJSRouter;
     /**
      * Define a PUT route
      */
-    put(path: string, ...args: any[]): Router;
+    put(path: string, ...args: any[]): ArcanaJSRouter;
     /**
      * Define a DELETE route
      */
-    delete(path: string, ...args: any[]): Router;
+    delete(path: string, ...args: any[]): ArcanaJSRouter;
     /**
      * Define a PATCH route
      */
-    patch(path: string, ...args: any[]): Router;
+    patch(path: string, ...args: any[]): ArcanaJSRouter;
     /**
      * Define an OPTIONS route
      */
-    options(path: string, ...args: any[]): Router;
+    options(path: string, ...args: any[]): ArcanaJSRouter;
     /**
-     * Get the underlying Express router
+     * Define a resource route
+     * Registers index, create, store, show, edit, update, destroy routes
      */
-    getRouter(): ExpressRouter;
+    resource(path: string, controller: any): ArcanaJSRouter;
     /**
-     * Mount this router to an Express app or router
+     * Get the underlying Express router
      */
-    mount(app: express.Application | ExpressRouter, basePath?: string): void;
+    getRouter(): ExpressRouter;
     /**
      * Clone the current router instance
      */
@@ -63,6 +60,10 @@ export declare class Router {
      * Add a route to the router
      */
     private _addRoute;
+    /**
+     * Resolve middleware to RequestHandler
+     */
+    private _resolveMiddleware;
     /**
      * Build the full path with prefixes
      */
@@ -77,18 +78,16 @@ export declare class Router {
  */
 export declare class Route {
     private static _router;
-    static create(): Router;
-    static middleware(...middleware: RequestHandler[]): Router;
-    static prefix(prefix: string): Router;
-    static group(callback: (router: Router) => void): Router;
-    static get(path: string, ...args: any[]): Router;
-    static post(path: string, ...args: any[]): Router;
-    static put(path: string, ...args: any[]): Router;
-    static delete(path: string, ...args: any[]): Router;
-    static patch(path: string, ...args: any[]): Router;
-    static options(path: string, ...args: any[]): Router;
+    static middleware(...middleware: any[]): typeof Route;
+    static prefix(prefix: string): typeof Route;
+    static group(callback: (router: ArcanaJSRouter) => void): typeof Route;
+    static get(path: string, ...args: any[]): typeof Route;
+    static post(path: string, ...args: any[]): typeof Route;
+    static put(path: string, ...args: any[]): typeof Route;
+    static delete(path: string, ...args: any[]): typeof Route;
+    static patch(path: string, ...args: any[]): typeof Route;
+    static options(path: string, ...args: any[]): typeof Route;
+    static resource(path: string, controller: any): typeof Route;
     static getRouter(): ExpressRouter;
-    static mount(app: express.Application, basePath?: string): void;
-    static reset(): void;
 }
 export default Route;

package/dist/lib/server/http/FormRequest.d.ts

@@ -0,0 +1,10 @@
+import { Request } from "express";
+export declare abstract class FormRequest {
+    protected req: Request;
+    constructor(req: Request);
+    abstract rules(): Record<string, string>;
+    authorize(): boolean;
+    validate(): Promise<Record<string, any>>;
+    input(key: string, defaultValue?: any): any;
+    all(): any;
+}

package/dist/lib/server/http/JsonResource.d.ts

@@ -0,0 +1,13 @@
+export declare class JsonResource {
+    resource: any;
+    constructor(resource: any);
+    static make(resource: any): JsonResource;
+    static collection(resource: any[]): AnonymousResourceCollection;
+    resolve(request?: any): any;
+    toArray(request?: any): any;
+}
+export declare class AnonymousResourceCollection extends JsonResource {
+    collects: any;
+    constructor(resource: any[], collects: any);
+    resolve(request?: any): any;
+}

package/dist/lib/server/http/Middleware.d.ts

@@ -0,0 +1,4 @@
+import { NextFunction, Request, Response } from "express";
+export interface Middleware {
+    handle(req: Request, res: Response, next: NextFunction): void | Promise<void>;
+}

package/dist/lib/server/support/ServiceProvider.d.ts

@@ -0,0 +1,17 @@
+import ArcanaJSServer from "../ArcanaJSServer";
+export declare abstract class ServiceProvider {
+    protected app: ArcanaJSServer;
+    constructor(app: ArcanaJSServer);
+    /**
+     * Register any application services.
+     */
+    register(): void;
+    /**
+     * Bootstrap any application services.
+     */
+    boot(): void;
+    /**
+     * Shutdown any application services.
+     */
+    shutdown(): Promise<void>;
+}

package/dist/lib/server/utils/dynamicRequire.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Helper to dynamically require modules at runtime, bypassing Webpack bundling.
+ * This is necessary for loading user configuration files, migrations, and views
+ * that are not part of the framework bundle but exist in the user's project.
+ */
+export declare const dynamicRequire: (id: string) => any;

package/dist/lib/validation/ValidationException.d.ts

@@ -0,0 +1,5 @@
+export declare class ValidationException extends Error {
+    errors: Record<string, string[]>;
+    status: number;
+    constructor(errors: Record<string, string[]>);
+}

package/dist/lib/validation/Validator.d.ts

@@ -0,0 +1,55 @@
+import type { DatabaseAdapter } from "../arcanox/types";
+export declare class Validator {
+    protected data: any;
+    protected rules: Record<string, string>;
+    protected errors: Record<string, string[]>;
+    protected databaseAdapter?: DatabaseAdapter;
+    /**
+     * Map of custom validator functions.
+     */
+    private static customValidators;
+    /**
+     * Register a custom validator.
+     */
+    static registerValidator(name: string, fn: (value: any, data: any, param?: string) => true | string | Promise<true | string>): void;
+    constructor(data: any, rules: Record<string, string>);
+    static make(data: any, rules: Record<string, string>): Validator;
+    /**
+     * Set the database adapter for database validation rules
+     */
+    setDatabaseAdapter(adapter: DatabaseAdapter): this;
+    fails(): Promise<boolean>;
+    passes(): Promise<boolean>;
+    errors_(): Record<string, string[]>;
+    validate(): Promise<Record<string, any>>;
+    protected validateRules(): Promise<Record<string, any>>;
+    /**
+     * Check if any rules require database adapter
+     */
+    protected needsDatabaseAdapter(): boolean;
+    /**
+     * Auto-inject database adapter from Container
+     */
+    protected autoInjectDatabaseAdapter(): Promise<void>;
+    protected getValue(field: string): any;
+    protected applyRule(field: string, value: any, rule: string): Promise<void>;
+    protected validateArrayContent(field: string, array: any[], type: string): Promise<void>;
+    protected validateMin(field: string, value: any, param: string): void;
+    protected validateMax(field: string, value: any, param: string): void;
+    protected isValidJson(value: any): boolean;
+    protected isEmpty(value: any): boolean;
+    /**
+     * Validate unique rule: unique:table,column,ignoreId,ignoreColumn
+     * Examples:
+     * - unique:users,email
+     * - unique:users,email,5 (ignore record with id=5)
+     * - unique:users,email,5,user_id (ignore record where user_id=5)
+     */
+    protected validateUnique(field: string, value: any, param: string): Promise<void>;
+    /**
+     * Validate exists rule: exists:table,column
+     * Example: exists:riads,id
+     */
+    protected validateExists(field: string, value: any, param: string): Promise<void>;
+    protected addError(field: string, message: string): void;
+}

package/dist/types/global.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Global type declarations for ArcanaJS
+ * This file provides type support for CSS imports in projects using ArcanaJS
+ */
+
+/// <reference types="react" />
+
+// CSS Module declarations
+declare module "*.css" {
+  const content: { [className: string]: string };
+  export default content;
+}
+
+declare module "*.module.css" {
+  const classes: { [key: string]: string };
+  export default classes;
+}
+
+// SCSS declarations
+declare module "*.scss" {
+  const content: { [className: string]: string };
+  export default content;
+}
+
+declare module "*.module.scss" {
+  const classes: { [key: string]: string };
+  export default classes;
+}
+
+// SASS declarations
+declare module "*.sass" {
+  const content: { [className: string]: string };
+  export default content;
+}
+
+declare module "*.module.sass" {
+  const classes: { [key: string]: string };
+  export default classes;
+}
+
+// LESS declarations
+declare module "*.less" {
+  const content: { [className: string]: string };
+  export default content;
+}
+
+declare module "*.module.less" {
+  const classes: { [key: string]: string };
+  export default classes;
+}
+
+// Image file declarations
+declare module "*.png" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.jpg" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.jpeg" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.gif" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.svg" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.webp" {
+  const value: string;
+  export default value;
+}
+
+// Font file declarations
+declare module "*.woff" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.woff2" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.ttf" {
+  const value: string;
+  export default value;
+}
+
+declare module "*.eot" {
+  const value: string;
+  export default value;
+}

package/package.json

@@ -5,32 +5,37 @@
     "email": "mohammed.bencheikh.dev@gmail.com",
     "url": "https://mohammedbencheikh.com/"
   },
-  "version": "3.0.1",
+  "version": "5.0.0",
   "description": "ArcanaJS Framework",
   "main": "./dist/arcanajs.js",
-  "types": "./dist/lib/index.d.ts",
   "scripts": {
-    "build": "tsc -p tsconfig.json --emitDeclarationOnly && webpack --config webpack.config.ts && cp src/lib/global.d.ts dist/lib/"
+    "build": "tsc -p tsconfig.json --emitDeclarationOnly && webpack --config webpack.config.ts && cp -r src/types dist/ && node scripts/post-build.js",
+    "test": "echo \"No tests specified\" && exit 0"
   },
   "exports": {
-    ".": {
-      "browser": {
-        "types": "./dist/lib/index.client.d.ts",
-        "default": "./dist/arcanajs.client.js"
-      },
-      "node": {
-        "types": "./dist/lib/index.d.ts",
-        "default": "./dist/arcanajs.js"
-      },
+    "./server": {
+      "types": "./dist/lib/index.server.d.ts",
       "default": "./dist/arcanajs.js"
     },
+    "./arcanox": {
+      "types": "./dist/lib/index.arcanox.d.ts",
+      "default": "./dist/arcanox.js"
+    },
     "./client": {
       "types": "./dist/lib/index.client.d.ts",
       "default": "./dist/arcanajs.client.js"
     },
-    "./server": {
-      "types": "./dist/lib/index.d.ts",
-      "default": "./dist/arcanajs.js"
+    "./auth": {
+      "types": "./dist/lib/index.auth.d.ts",
+      "default": "./dist/arcanajs.auth.js"
+    },
+    "./validator": {
+      "types": "./dist/lib/index.validator.d.ts",
+      "default": "./dist/arcanajs.validator.js"
+    },
+    "./mail": {
+      "types": "./dist/lib/index.mail.d.ts",
+      "default": "./dist/arcanajs.mail.js"
     }
   },
   "bin": {
@@ -41,38 +46,75 @@
     "bin"
   ],
   "peerDependencies": {
+    "@aws-sdk/client-ses": "^3.0.0",
+    "connect-redis": "^7.0.0",
+    "handlebars": "^4.7.0",
+    "ioredis": "^5.0.0",
+    "mongodb": "^6.0.0 || ^7.0.0",
+    "mysql2": "^3.0.0",
+    "nodemailer-mailgun-transport": "^2.0.0",
+    "pg": "^8.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "@faker-js/faker": {
+      "optional": true
+    },
+    "mongodb": {
+      "optional": true
+    },
+    "@aws-sdk/client-ses": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "connect-redis": {
+      "optional": true
+    },
+    "handlebars": {
+      "optional": true
+    },
+    "nodemailer-mailgun-transport": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@babel/core": "^7.23.0",
     "@babel/preset-env": "^7.23.0",
     "@babel/preset-react": "^7.22.15",
     "@babel/preset-typescript": "^7.23.0",
-    "@tailwindcss/postcss": "^4.1.17",
-    "@types/compression": "^1.8.1",
-    "@types/cookie-parser": "^1.4.10",
-    "@types/express": "^5.0.5",
-    "@types/node": "^24.10.1",
-    "@types/react": "^19.2.7",
-    "@types/react-dom": "^19.2.3",
     "@types/ws": "^8.18.1",
-    "autoprefixer": "^10.4.22",
     "babel-loader": "^10.0.0",
+    "bcryptjs": "^2.4.3",
     "clean-webpack-plugin": "^4.0.0",
     "compression": "^1.8.1",
     "cookie-parser": "^1.4.7",
     "cross-env": "^10.1.0",
     "css-loader": "^7.1.2",
+    "dotenv": "^16.6.1",
+    "ejs": "^3.1.9",
     "express": "^5.1.0",
+    "express-session": "^1.18.0",
+    "express-validator": "^7.3.1",
     "helmet": "^8.1.0",
     "html-webpack-plugin": "^5.6.5",
+    "jsonwebtoken": "^9.0.2",
     "mini-css-extract-plugin": "^2.9.4",
+    "nodemailer": "^7.0.11",
     "null-loader": "^4.0.1",
     "postcss": "^8.5.6",
     "postcss-loader": "^8.2.0",
+    "redis": "^4.6.12",
+    "reflect-metadata": "^0.2.2",
     "style-loader": "^4.0.0",
-    "tailwindcss": "^4.1.17",
     "ts-node": "^10.9.2",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
@@ -82,9 +124,32 @@
     "ws": "^8.18.3"
   },
   "devDependencies": {
+    "@aws-sdk/client-ses": "^3.490.0",
+    "@faker-js/faker": "^10.1.0",
+    "@tailwindcss/postcss": "^4.1.17",
+    "@types/bcryptjs": "^2.4.6",
+    "@types/compression": "^1.8.1",
+    "@types/cookie-parser": "^1.4.10",
+    "@types/ejs": "^3.1.5",
+    "@types/express-session": "^1.18.0",
+    "@types/jsonwebtoken": "^9.0.5",
+    "@types/node": "^24.10.1",
+    "@types/nodemailer": "^7.0.4",
+    "@types/pg": "^8.15.6",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
     "@types/webpack-node-externals": "^3.0.4",
+    "autoprefixer": "^10.4.22",
+    "connect-redis": "^7.1.0",
+    "handlebars": "^4.7.8",
+    "ioredis": "^5.3.2",
+    "mongodb": "^7.0.0",
+    "mysql2": "^3.15.3",
+    "nodemailer-mailgun-transport": "^2.1.5",
+    "pg": "^8.16.3",
     "react": "^19.2.0",
-    "react-dom": "^19.2.0"
+    "react-dom": "^19.2.0",
+    "tailwindcss": "^4.1.17"
   },
   "keywords": [
     "arcanajs",

package/dist/lib/global.d.ts

@@ -1,61 +0,0 @@
-// ============================================================================
-// Express Augmentation
-// ============================================================================
-declare module "*.module.css" {
-  const classes: { readonly [key: string]: string };
-  export default classes;
-}
-declare module "*.css";
-
-declare global {
-  var __non_webpack_require__: NodeJS.Require;
-  namespace Express {
-    interface Request {
-      /**
-       * Normalized DB object optionally attached to the request by ArcanaJSServer.
-       * It may be either the raw client, or an object like `{ client, db, close }`.
-       */
-      db?: any;
-    }
-    interface Response {
-      /**
-       * Render a page component with data
-       * @param page - Name of the page component to render
-       * @param data - Data to pass to the page component
-       */
-      renderPage(page: string, data?: any): void;
-
-      /**
-       * Send a success JSON response
-       * @param data - Data to send in the response
-       * @param message - Optional success message
-       * @param status - HTTP status code (default: 200)
-       */
-      success(
-        data?: string | object | null,
-        message?: string,
-        status?: number
-      ): Response;
-
-      /**
-       * Send an error JSON response
-       * @param message - Error message
-       * @param status - HTTP status code (default: 500)
-       * @param error - Error details
-       * @param data - Additional error data
-       */
-      error(
-        message?: string,
-        status?: number,
-        error?: string | object | null,
-        data?: string | object | null
-      ): Response;
-    }
-  }
-
-  // ============================================================================
-  // CSS Module Declarations
-  // ============================================================================
-}
-
-export {};