arcanajs 4.0.0 → 5.0.0

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

@@ -1,7 +1,7 @@
 import { Express, RequestHandler } from "express";
 import React from "react";
 import { ServiceProvider } from "./support/ServiceProvider";
-export interface ArcanaJSConfig<TDb = any> {
+export interface ArcanaJSConfig {
     port?: number | string;
     views?: Record<string, React.FC<any>>;
     viewsDir?: string;
@@ -15,10 +15,14 @@ export interface ArcanaJSConfig<TDb = any> {
     distDir?: string;
     indexFile?: string;
     layout?: React.FC<any>;
-    /** Optional function to establish a DB connection. Should return a Promise resolving to the DB client/connection. */
-    dbConnect?: () => Promise<TDb> | TDb;
     /** Automatically register SIGINT/SIGTERM handlers to call stop(). Default: true */
     autoHandleSignals?: boolean;
+    /** Auth configuration */
+    auth?: any;
+    /** Mail configuration */
+    mail?: any;
+    /** Database configuration */
+    database?: any;
     /** Service providers to load */
     providers?: (new (app: ArcanaJSServer) => ServiceProvider)[];
 }
@@ -43,7 +47,7 @@ declare global {
              * @param data - Optional data payload to include in the error response (default: null).
              * @returns The Express Response object.
              */
-            error: (message?: string, status?: number, error?: string | object | null, data?: string | object | null) => Response;
+            error: (message?: string, status?: number, error?: string | object | null | undefined | unknown, data?: string | object | null) => Response;
             /**
              * Renders a React page using ArcanaJS SSR.
              *
@@ -57,7 +61,7 @@ declare global {
     }
 }
 import { Container } from "./Container";
-declare class ArcanaJSServer<TDb = any> {
+declare class ArcanaJSServer {
     app: Express;
     container: Container;
     private config;
@@ -65,14 +69,17 @@ declare class ArcanaJSServer<TDb = any> {
     private _sigintHandler?;
     private _sigtermHandler?;
     private providers;
-    constructor(config: ArcanaJSConfig<TDb>);
+    private initialized;
+    constructor(config: ArcanaJSConfig);
+    private initializeAsync;
+    private loadConfigurations;
     private registerProviders;
     private bootProviders;
-    private initialize;
+    private setupMiddleware;
     private loadViewsFromContext;
     private loadViewsFromAlias;
     private discoverViews;
-    start(): void;
+    start(): Promise<void>;
     /**
      * Stop the HTTP server and close DB connection if present.
      */

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

@@ -22,6 +22,14 @@ export declare class Container {
      * Resolve a dependency from the container
      */
     make<T>(key: string | ClassConstructor<T>): T;
+    /**
+     * Check if a service is registered in the container
+     */
+    has(key: string | ClassConstructor): boolean;
+    /**
+     * Alias for make() - resolve a dependency from the container
+     */
+    resolve<T>(key: string | ClassConstructor<T>): T;
     /**
      * Instantiate a class, resolving its dependencies
      */

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

@@ -1,65 +1,57 @@
-import express, { Router as ExpressRouter } 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: any[]): 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;
     /**
      * Define a resource route
      * Registers index, create, store, show, edit, update, destroy routes
      */
-    resource(path: string, controller: any): Router;
+    resource(path: string, controller: any): ArcanaJSRouter;
     /**
      * Get the underlying Express router
      */
     getRouter(): ExpressRouter;
-    /**
-     * Mount this router to an Express app or router
-     */
-    mount(app: express.Application | ExpressRouter, basePath?: string): void;
     /**
      * Clone the current router instance
      */
@@ -86,18 +78,16 @@ export declare class Router {
  */
 export declare class Route {
     private static _router;
-    static create(): Router;
-    static middleware(...middleware: any[]): 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/support/ServiceProvider.d.ts

@@ -10,4 +10,8 @@ export declare abstract class ServiceProvider {
      * Bootstrap any application services.
      */
     boot(): void;
+    /**
+     * Shutdown any application services.
+     */
+    shutdown(): Promise<void>;
 }

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,13 +5,18 @@
     "email": "mohammed.bencheikh.dev@gmail.com",
     "url": "https://mohammedbencheikh.com/"
   },
-  "version": "4.0.0",
+  "version": "5.0.0",
   "description": "ArcanaJS Framework",
   "main": "./dist/arcanajs.js",
   "scripts": {
-    "build": "tsc -p tsconfig.json --emitDeclarationOnly && webpack --config webpack.config.ts"
+    "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": {
+    "./server": {
+      "types": "./dist/lib/index.server.d.ts",
+      "default": "./dist/arcanajs.js"
+    },
     "./arcanox": {
       "types": "./dist/lib/index.arcanox.d.ts",
       "default": "./dist/arcanox.js"
@@ -20,9 +25,17 @@
       "types": "./dist/lib/index.client.d.ts",
       "default": "./dist/arcanajs.client.js"
     },
-    "./server": {
-      "types": "./dist/lib/index.server.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": {
@@ -33,6 +46,14 @@
     "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"
   },
@@ -48,6 +69,21 @@
     },
     "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": {
@@ -55,31 +91,30 @@
     "@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",
@@ -89,14 +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/arcanox/index.d.ts

@@ -1,13 +0,0 @@
-export { MongoAdapter } from "./adapters/MongoAdapter";
-export { MySQLAdapter } from "./adapters/MySQLAdapter";
-export { PostgresAdapter } from "./adapters/PostgresAdapter";
-export { Model } from "./Model";
-export { QueryBuilder } from "./QueryBuilder";
-export { BelongsTo } from "./relations/BelongsTo";
-export { BelongsToMany } from "./relations/BelongsToMany";
-export { HasMany } from "./relations/HasMany";
-export { HasOne } from "./relations/HasOne";
-export { Relation } from "./relations/Relation";
-export { Macroable } from "./support/Macroable";
-export type { ColumnDefinition, Connection, DatabaseAdapter, DatabaseConfig, JoinClause, OrderByClause, SelectOptions, WhereClause, } from "./types";
-export * from "./extensions/MongoExtensions";

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

@@ -1,12 +0,0 @@
-export declare class Validator {
-    protected data: any;
-    protected rules: Record<string, string>;
-    protected errors: Record<string, string[]>;
-    constructor(data: any, rules: Record<string, string>);
-    static make(data: any, rules: Record<string, string>): Validator;
-    fails(): boolean;
-    passes(): boolean;
-    errors_(): Record<string, string[]>;
-    validate(): Record<string, any>;
-    protected addError(field: string, message: string): void;
-}