arcanajs 3.0.1 → 5.0.0

package/dist/lib/arcanox/schema/Blueprint.d.ts

@@ -0,0 +1,183 @@
+import type { ColumnDefinition } from "../types";
+/**
+ * Column definition builder - fluent interface for defining columns
+ */
+export declare class ColumnBuilder {
+    private definition;
+    constructor(name: string, type: string, length?: number);
+    /**
+     * Make column nullable
+     */
+    nullable(): this;
+    /**
+     * Set default value
+     */
+    default(value: any): this;
+    /**
+     * Make column unique
+     */
+    unique(): this;
+    /**
+     * Make column primary key
+     */
+    primary(): this;
+    /**
+     * Make column auto-increment
+     */
+    autoIncrement(): this;
+    /**
+     * Make column unsigned (for numbers)
+     */
+    unsigned(): this;
+    /**
+     * Get the column definition
+     */
+    getDefinition(): ColumnDefinition;
+}
+/**
+ * Foreign key definition builder
+ */
+export declare class ForeignKeyBuilder {
+    private column;
+    private referencedTable?;
+    private referencedColumn?;
+    private onDeleteAction?;
+    private onUpdateAction?;
+    constructor(column: string);
+    /**
+     * Set referenced table and column
+     */
+    references(column: string): this;
+    /**
+     * Set referenced table
+     */
+    on(table: string): this;
+    /**
+     * Set ON DELETE action
+     */
+    onDelete(action: "CASCADE" | "SET NULL" | "RESTRICT" | "NO ACTION"): this;
+    /**
+     * Set ON UPDATE action
+     */
+    onUpdate(action: "CASCADE" | "SET NULL" | "RESTRICT" | "NO ACTION"): this;
+    /**
+     * Get foreign key SQL
+     */
+    toSQL(): string;
+}
+/**
+ * Blueprint - defines table structure
+ * Arcanox's Schema Blueprint
+ */
+export declare class Blueprint {
+    private tableName;
+    private columns;
+    private indexes;
+    private foreignKeys;
+    private primaryKeys;
+    constructor(tableName: string);
+    /**
+     * Add auto-incrementing ID column
+     */
+    id(name?: string): ColumnBuilder;
+    /**
+     * Add UUID column
+     */
+    uuid(name?: string): ColumnBuilder;
+    /**
+     * Add string column
+     */
+    string(name: string, length?: number): ColumnBuilder;
+    /**
+     * Add text column
+     */
+    text(name: string): ColumnBuilder;
+    /**
+     * Add integer column
+     */
+    integer(name: string): ColumnBuilder;
+    /**
+     * Add big integer column
+     */
+    bigInteger(name: string): ColumnBuilder;
+    /**
+     * Add decimal column
+     */
+    decimal(name: string, precision?: number, scale?: number): ColumnBuilder;
+    /**
+     * Add float column
+     */
+    float(name: string): ColumnBuilder;
+    /**
+     * Add double column
+     */
+    double(name: string): ColumnBuilder;
+    /**
+     * Add boolean column
+     */
+    boolean(name: string): ColumnBuilder;
+    /**
+     * Add date column
+     */
+    date(name: string): ColumnBuilder;
+    /**
+     * Add datetime column
+     */
+    datetime(name: string): ColumnBuilder;
+    /**
+     * Add timestamp column
+     */
+    timestamp(name: string): ColumnBuilder;
+    /**
+     * Add created_at and updated_at timestamps
+     */
+    timestamps(): void;
+    /**
+     * Add deleted_at timestamp for soft deletes
+     */
+    softDeletes(name?: string): ColumnBuilder;
+    /**
+     * Add JSON column
+     */
+    json(name: string): ColumnBuilder;
+    /**
+     * Add enum column
+     */
+    enum(name: string, values: string[]): ColumnBuilder;
+    /**
+     * Add foreign key constraint
+     */
+    foreign(column: string): ForeignKeyBuilder;
+    /**
+     * Add index
+     */
+    index(columns: string | string[], name?: string): void;
+    /**
+     * Add unique index
+     */
+    unique(columns: string | string[], name?: string): void;
+    /**
+     * Set primary key
+     */
+    primary(columns: string | string[]): void;
+    /**
+     * Get all columns
+     */
+    getColumns(): ColumnDefinition[];
+    /**
+     * Get table name
+     */
+    getTableName(): string;
+    /**
+     * Get indexes
+     */
+    getIndexes(): {
+        columns: string[];
+        unique: boolean;
+        name?: string;
+    }[];
+    /**
+     * Get foreign keys
+     */
+    getForeignKeys(): ForeignKeyBuilder[];
+}

package/dist/lib/arcanox/schema/Migration.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Base Migration class
+ * All migrations should extend this class and implement up() and down() methods
+ */
+export declare abstract class Migration {
+    /**
+     * Run the migration
+     */
+    abstract up(): Promise<void>;
+    /**
+     * Reverse the migration
+     */
+    abstract down(): Promise<void>;
+}
+/**
+ * Migration status
+ */
+export interface MigrationStatus {
+    name: string;
+    batch: number;
+    ranAt: Date;
+}
+/**
+ * Migration record in database
+ */
+export interface MigrationRecord {
+    id?: number;
+    migration: string;
+    batch: number;
+    created_at?: Date;
+}
+/**
+ * Migration Runner - executes migrations
+ */
+export declare class MigrationRunner {
+    private adapter;
+    private migrationsTable;
+    private migrationsPath;
+    constructor(adapter: any, migrationsPath: string);
+    /**
+     * Ensure migrations table exists
+     */
+    private ensureMigrationsTable;
+    /**
+     * Get all ran migrations
+     */
+    private getRanMigrations;
+    /**
+     * Get pending migrations
+     */
+    private getPendingMigrations;
+    /**
+     * Run pending migrations
+     */
+    run(): Promise<void>;
+    /**
+     * Rollback last batch of migrations
+     */
+    rollback(steps?: number): Promise<void>;
+    /**
+     * Reset all migrations
+     */
+    reset(): Promise<void>;
+    /**
+     * Reset and re-run all migrations
+     */
+    fresh(): Promise<void>;
+    /**
+     * Get migration status
+     */
+    status(): Promise<MigrationStatus[]>;
+    /**
+     * Load migration class from file
+     */
+    private loadMigration;
+}

package/dist/lib/arcanox/schema/Schema.d.ts

@@ -0,0 +1,49 @@
+import type { DatabaseAdapter } from "../types";
+import { Blueprint } from "./Blueprint";
+/**
+ * Schema - ArcnanJS schema builder
+ * Provides fluent interface for creating and modifying database tables
+ */
+export declare class Schema {
+    private static adapter;
+    /**
+     * Set the database adapter
+     */
+    static setAdapter(adapter: DatabaseAdapter): void;
+    /**
+     * Create a new table
+     */
+    static create(tableName: string, callback: (table: Blueprint) => void): Promise<void>;
+    /**
+     * Modify an existing table
+     */
+    static table(tableName: string, callback: (table: Blueprint) => void): Promise<void>;
+    /**
+     * Drop a table
+     */
+    static drop(tableName: string): Promise<void>;
+    /**
+     * Drop a table if it exists
+     */
+    static dropIfExists(tableName: string): Promise<void>;
+    /**
+     * Rename a table
+     */
+    static rename(from: string, to: string): Promise<void>;
+    /**
+     * Check if a table exists
+     */
+    static hasTable(tableName: string): Promise<boolean>;
+    /**
+     * Check if a column exists in a table
+     */
+    static hasColumn(tableName: string, columnName: string): Promise<boolean>;
+    /**
+     * Get all tables
+     */
+    static getTables(): Promise<string[]>;
+    /**
+     * Get all columns for a table
+     */
+    static getColumns(tableName: string): Promise<string[]>;
+}

package/dist/lib/arcanox/schema/index.d.ts

@@ -0,0 +1,4 @@
+export { Blueprint, ColumnBuilder, ForeignKeyBuilder } from "./Blueprint";
+export { Migration, MigrationRunner } from "./Migration";
+export type { MigrationRecord, MigrationStatus } from "./Migration";
+export { Schema } from "./Schema";

package/dist/lib/arcanox/seeder/Seeder.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Base Seeder class
+ */
+export declare abstract class Seeder {
+    /**
+     * Run the database seeds.
+     */
+    abstract run(): Promise<void>;
+    /**
+     * Call another seeder
+     */
+    call(SeederClass: new () => Seeder): Promise<void>;
+}

package/dist/lib/arcanox/seeder/index.d.ts

@@ -0,0 +1 @@
+export { Seeder } from "./Seeder";

package/dist/lib/arcanox/support/Macroable.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Macroable trait
+ * Allows adding custom methods to a class at runtime
+ */
+export declare class Macroable {
+    protected static macros: Record<string, Function>;
+    /**
+     * Register a custom macro
+     */
+    static macro(name: string, macro: Function): void;
+    /**
+     * Mix another object into the class
+     */
+    static mixin(mixin: Record<string, Function>): void;
+    /**
+     * Check if macro exists
+     */
+    static hasMacro(name: string): boolean;
+}

package/dist/lib/arcanox/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Database connection interface
+ */
+export interface Connection {
+    query(sql: string, params?: any[]): Promise<any>;
+    execute(sql: string, params?: any[]): Promise<any>;
+    close(): Promise<void>;
+}
+/**
+ * Database adapter interface - implements database-specific operations
+ */
+export interface DatabaseAdapter {
+    connect(config: DatabaseConfig): Promise<Connection>;
+    disconnect(): Promise<void>;
+    createTable(tableName: string, columns: ColumnDefinition[]): Promise<void>;
+    dropTable(tableName: string): Promise<void>;
+    hasTable(tableName: string): Promise<boolean>;
+    hasColumn(tableName: string, columnName: string): Promise<boolean>;
+    select(table: string, options: SelectOptions): Promise<any[]>;
+    insert(table: string, data: Record<string, any>): Promise<any>;
+    update(table: string, id: any, data: Record<string, any>): Promise<any>;
+    delete(table: string, id: any): Promise<boolean>;
+    beginTransaction(): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    raw(query: string, params?: any[]): Promise<any>;
+}
+export interface DatabaseConfig {
+    type: "postgres" | "mysql" | "mongodb";
+    host: string;
+    port: number;
+    database: string;
+    username?: string;
+    password?: string;
+    ssl?: boolean;
+    pool?: {
+        min?: number;
+        max?: number;
+    };
+}
+export interface ColumnDefinition {
+    name: string;
+    type: string;
+    length?: number;
+    nullable?: boolean;
+    default?: any;
+    unique?: boolean;
+    primary?: boolean;
+    autoIncrement?: boolean;
+    unsigned?: boolean;
+}
+export interface SelectOptions {
+    columns?: string[];
+    where?: WhereClause[];
+    orderBy?: OrderByClause[];
+    limit?: number;
+    offset?: number;
+    joins?: JoinClause[];
+}
+export interface WhereClause {
+    column: string;
+    operator: "=" | "!=" | ">" | "<" | ">=" | "<=" | "LIKE" | "IN" | "NOT IN" | "BETWEEN" | "IS NULL" | "IS NOT NULL";
+    value: any;
+    boolean?: "AND" | "OR";
+}
+export interface OrderByClause {
+    column: string;
+    direction: "ASC" | "DESC";
+}
+export interface JoinClause {
+    type: "INNER" | "LEFT" | "RIGHT";
+    table: string;
+    first: string;
+    operator: string;
+    second: string;
+}

package/dist/lib/auth/AuthProvider.d.ts

@@ -0,0 +1,10 @@
+import { ServiceProvider } from "../server/support/ServiceProvider";
+/**
+ * Authentication Service Provider
+ *
+ * Registers and bootstraps the authentication system
+ */
+export declare class AuthProvider extends ServiceProvider {
+    register(): Promise<void>;
+    boot(): Promise<void>;
+}

package/dist/lib/auth/JWTService.d.ts

@@ -0,0 +1,11 @@
+import jwt from "jsonwebtoken";
+import { AuthConfig, JWTPayload } from "./types";
+export declare class JWTService {
+    private static config;
+    static init(config: AuthConfig["jwt"]): void;
+    static generateToken(payload: JWTPayload, options?: jwt.SignOptions): string;
+    static generateRefreshToken(payload: JWTPayload): string;
+    static verifyToken(token: string): Promise<JWTPayload>;
+    static revokeToken(token: string): Promise<void>;
+    static refreshAccessToken(refreshToken: string): Promise<string>;
+}

package/dist/lib/auth/SessionManager.d.ts

@@ -0,0 +1,4 @@
+import { AuthConfig } from "./types";
+export declare class SessionManager {
+    static createMiddleware(config: AuthConfig["session"]): import("express").RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>;
+}

package/dist/lib/auth/middleware/AuthMiddleware.d.ts

@@ -0,0 +1,5 @@
+import { NextFunction, Request, Response } from "express";
+import { Middleware } from "../../server/http/Middleware";
+export declare class AuthMiddleware implements Middleware {
+    handle(req: Request, res: Response, next: NextFunction): Promise<void>;
+}

package/dist/lib/auth/middleware/AuthenticatedMiddleware.d.ts

@@ -0,0 +1,5 @@
+import { NextFunction, Request, Response } from "express";
+import { Middleware } from "../../server/http/Middleware";
+export declare class AuthenticatedMiddleware implements Middleware {
+    handle(req: Request, res: Response, next: NextFunction): void;
+}

package/dist/lib/auth/middleware/GuestMiddleware.d.ts

@@ -0,0 +1,5 @@
+import { NextFunction, Request, Response } from "express";
+import { Middleware } from "../../server/http/Middleware";
+export declare class GuestMiddleware implements Middleware {
+    handle(req: Request, res: Response, next: NextFunction): void;
+}

package/dist/lib/auth/middleware/RoleMiddleware.d.ts

@@ -0,0 +1,7 @@
+import { NextFunction, Request, Response } from "express";
+import { Middleware } from "../../server/http/Middleware";
+export declare class RoleMiddleware implements Middleware {
+    private roles;
+    constructor(...roles: string[]);
+    handle(req: Request, res: Response, next: NextFunction): void;
+}

package/dist/lib/auth/types/AuthConfig.d.ts

@@ -0,0 +1,24 @@
+export interface AuthConfig {
+    jwt: {
+        secret: string;
+        accessTokenExpiry?: string | number;
+        refreshTokenExpiry?: string | number;
+        algorithm?: "HS256" | "RS256";
+    };
+    session: {
+        secret: string;
+        name?: string;
+        maxAge?: number;
+        secure?: boolean;
+        redis?: {
+            host: string;
+            port: number;
+            password?: string;
+            db?: number;
+        };
+    };
+    tokenBlacklist?: {
+        enabled: boolean;
+        storage: "memory" | "redis";
+    };
+}

package/dist/lib/auth/types/JWTPayload.d.ts

@@ -0,0 +1,10 @@
+export interface JWTPayload {
+    sub: string;
+    email?: string;
+    roles?: string[];
+    permissions?: string[];
+    iat?: number;
+    exp?: number;
+    jti?: string;
+    [key: string]: any;
+}

package/dist/lib/auth/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./AuthConfig";
+export * from "./JWTPayload";

package/dist/lib/auth/utils/PasswordHasher.d.ts

@@ -0,0 +1,16 @@
+export declare class PasswordHasher {
+    private static readonly SALT_ROUNDS;
+    /**
+     * Hash a password.
+     * @param password The password to hash.
+     * @returns The hashed password.
+     */
+    static hash(password: string): Promise<string>;
+    /**
+     * Verify a password against a hash.
+     * @param password The plain text password.
+     * @param hash The hashed password.
+     * @returns True if the password matches the hash.
+     */
+    static verify(password: string, hash: string): Promise<boolean>;
+}

package/dist/lib/auth/utils/TokenBlacklist.d.ts

@@ -0,0 +1,9 @@
+import { AuthConfig } from "../types";
+export declare class TokenBlacklist {
+    private static redisClient;
+    private static memoryStore;
+    private static config;
+    static init(config: AuthConfig["tokenBlacklist"], redisConfig?: AuthConfig["session"]["redis"]): Promise<void>;
+    static add(token: string, expiresInSeconds: number): Promise<void>;
+    static isRevoked(token: string): Promise<boolean>;
+}

package/dist/lib/index.arcanox.d.ts

@@ -0,0 +1,20 @@
+/// <reference path="../types/global.d.ts" />
+
+export { MongoAdapter } from "./arcanox/adapters/MongoAdapter";
+export { MySQLAdapter } from "./arcanox/adapters/MySQLAdapter";
+export { PostgresAdapter } from "./arcanox/adapters/PostgresAdapter";
+export { Model } from "./arcanox/Model";
+export { QueryBuilder } from "./arcanox/QueryBuilder";
+export { BelongsTo } from "./arcanox/relations/BelongsTo";
+export { BelongsToMany } from "./arcanox/relations/BelongsToMany";
+export { HasMany } from "./arcanox/relations/HasMany";
+export { HasOne } from "./arcanox/relations/HasOne";
+export { Relation } from "./arcanox/relations/Relation";
+export { Macroable } from "./arcanox/support/Macroable";
+export type { ColumnDefinition, Connection, DatabaseAdapter, DatabaseConfig, JoinClause, OrderByClause, SelectOptions, WhereClause, } from "./arcanox/types";
+export { Blueprint, Migration, MigrationRunner, Schema, } from "./arcanox/schema";
+export type { MigrationStatus } from "./arcanox/schema";
+export { Factory } from "./arcanox/factory";
+export { Seeder } from "./arcanox/seeder";
+export * from "./arcanox/extensions/MongoExtensions";
+export { DatabaseProvider } from "./arcanox/providers/DatabaseProvider";

package/dist/lib/index.auth.d.ts

@@ -0,0 +1,11 @@
+/// <reference path="../types/global.d.ts" />
+
+export { AuthProvider } from "./auth/AuthProvider";
+export { JWTService } from "./auth/JWTService";
+export { AuthenticatedMiddleware } from "./auth/middleware/AuthenticatedMiddleware";
+export { AuthMiddleware } from "./auth/middleware/AuthMiddleware";
+export { GuestMiddleware } from "./auth/middleware/GuestMiddleware";
+export { RoleMiddleware } from "./auth/middleware/RoleMiddleware";
+export { SessionManager } from "./auth/SessionManager";
+export type { AuthConfig, JWTPayload } from "./auth/types";
+export { PasswordHasher } from "./auth/utils/PasswordHasher";

package/dist/lib/index.client.d.ts

@@ -1,3 +1,5 @@
+/// <reference path="../types/global.d.ts" />
+
 export { default as Body } from "./shared/components/Body";
 export { default as Head } from "./shared/components/Head";
 export { default as Link } from "./shared/components/Link";

package/dist/lib/index.mail.d.ts

@@ -0,0 +1,8 @@
+/// <reference path="../types/global.d.ts" />
+
+export { Mailable } from "./mail/Mailable";
+export { MailProvider } from "./mail/MailProvider";
+export { MailService } from "./mail/MailService";
+export { MailQueue } from "./mail/queue/MailQueue";
+export type { MailAttachment, MailConfig, MailDriver, MailFromConfig, MailgunConfig, MailMessage, MailQueueConfig, MailTemplateConfig, SendGridConfig, SESConfig, SMTPConfig, } from "./mail/types";
+export { TemplateRenderer } from "./mail/utils/TemplateRenderer";

package/dist/lib/{index.d.ts → index.server.d.ts}

@@ -1,19 +1,13 @@
+/// <reference path="../types/global.d.ts" />
+
 import { Express } from "express";
 import ArcanaJSServer, { ArcanaJSConfig } from "./server/ArcanaJSServer";
-export { default as Body } from "./shared/components/Body";
-export { default as Head } from "./shared/components/Head";
-export { default as Link } from "./shared/components/Link";
-export { default as NavLink } from "./shared/components/NavLink";
-export { default as Page } from "./shared/components/Page";
-export { default as hydrateArcanaJS } from "./client/index";
-export { default as useLocation } from "./shared/hooks/useLocation";
-export { default as usePage } from "./shared/hooks/usePage";
-export { default as useParams } from "./shared/hooks/useParams";
-export { default as useQuery } from "./shared/hooks/useQuery";
-export { default as useRouter } from "./shared/hooks/useRouter";
 export { default as ArcanaJSServer } from "./server/ArcanaJSServer";
+export { Container } from "./server/Container";
 export { Express, NextFunction, Request, Response } from "express";
 export { default as Route } from "./server/Router";
+export type { Middleware } from "./server/http/Middleware";
+export { ServiceProvider } from "./server/support/ServiceProvider";
 /**
  * Create an ArcanaJS server with the given Express app
  *
@@ -29,7 +23,7 @@ export { default as Route } from "./server/Router";
  * const app = express();
  * const server = createArcanaServer(app, {
  *   port: 3000,
- *   viewsDir: 'src/views',
+ *   viewsDir: 'src/resources/views',
  * });
  *
  * server.start();

package/dist/lib/index.validator.d.ts

@@ -0,0 +1,6 @@
+/// <reference path="../types/global.d.ts" />
+
+export { FormRequest } from "./server/http/FormRequest";
+export { JsonResource } from "./server/http/JsonResource";
+export { ValidationException } from "./validation/ValidationException";
+export { Validator } from "./validation/Validator";

package/dist/lib/mail/MailProvider.d.ts

@@ -0,0 +1,10 @@
+import { ServiceProvider } from "../server/support/ServiceProvider";
+/**
+ * Mail Service Provider
+ *
+ * Registers and bootstraps the mail system
+ */
+export declare class MailProvider extends ServiceProvider {
+    register(): Promise<void>;
+    boot(): Promise<void>;
+}