@shohaghinfo/aerojs 0.1.0

package/dist/routing/route-group.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file route-group.ts
+ * @description Route groups allowing shared prefixes and group-level middleware.
+ */
+import type { DefaultState } from '../core/context.js';
+import type { Middleware } from '../core/types.js';
+import type { Router } from '../core/router.js';
+import type { RouteBuilder } from './route-builder.js';
+import type { NamedMiddlewareRegistry } from './named-middleware.js';
+export declare class RouteGroup<State = DefaultState> {
+    readonly prefix: string;
+    private readonly router;
+    private readonly namedMiddleware?;
+    private readonly middlewares;
+    constructor(prefix: string, router: Router<State>, namedMiddleware?: NamedMiddlewareRegistry<State> | undefined, parentMiddlewares?: (Middleware<State> | string)[]);
+    /**
+     * Adds group-level middleware executed on every route in this group.
+     */
+    use(...middlewares: (Middleware<State> | string)[]): this;
+    /**
+     * Alias for use().
+     */
+    middleware(...middlewares: (Middleware<State> | string)[]): this;
+    /**
+     * Creates a nested route group inheriting parent prefix and middlewares.
+     */
+    group(prefix: string, callback: (group: RouteGroup<State>) => void): this;
+    get(path: string, ...handlers: any[]): RouteBuilder<State>;
+    post(path: string, ...handlers: any[]): RouteBuilder<State>;
+    put(path: string, ...handlers: any[]): RouteBuilder<State>;
+    patch(path: string, ...handlers: any[]): RouteBuilder<State>;
+    delete(path: string, ...handlers: any[]): RouteBuilder<State>;
+    options(path: string, ...handlers: any[]): RouteBuilder<State>;
+    head(path: string, ...handlers: any[]): RouteBuilder<State>;
+    all(path: string, ...handlers: any[]): RouteBuilder<State>;
+    private addRoute;
+    private combinePrefixes;
+}
+//# sourceMappingURL=route-group.d.ts.map

package/dist/routing/route-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-group.d.ts","sourceRoot":"","sources":["../../src/routing/route-group.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAErE,qBAAa,UAAU,CAAC,KAAK,GAAG,YAAY;aAIxB,MAAM,EAAE,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IALnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;gBAGhD,MAAM,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,eAAe,CAAC,EAAE,uBAAuB,CAAC,KAAK,CAAC,YAAA,EACjE,iBAAiB,GAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,EAAO;IAKxD;;OAEG;IACI,GAAG,CAAC,GAAG,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI;IAKhE;;OAEG;IACI,UAAU,CAAC,GAAG,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI;IAIvE;;OAEG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,IAAI;IAYzE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI3D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI1D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI7D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI9D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAI3D,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC;IAIjE,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,eAAe;CAWxB"}

package/dist/routing/route-group.js

@@ -0,0 +1,79 @@
+/**
+ * @file route-group.ts
+ * @description Route groups allowing shared prefixes and group-level middleware.
+ */
+import { normalizePath } from '../core/utils.js';
+export class RouteGroup {
+    prefix;
+    router;
+    namedMiddleware;
+    middlewares = [];
+    constructor(prefix, router, namedMiddleware, parentMiddlewares = []) {
+        this.prefix = prefix;
+        this.router = router;
+        this.namedMiddleware = namedMiddleware;
+        this.middlewares.push(...parentMiddlewares);
+    }
+    /**
+     * Adds group-level middleware executed on every route in this group.
+     */
+    use(...middlewares) {
+        this.middlewares.push(...middlewares);
+        return this;
+    }
+    /**
+     * Alias for use().
+     */
+    middleware(...middlewares) {
+        return this.use(...middlewares);
+    }
+    /**
+     * Creates a nested route group inheriting parent prefix and middlewares.
+     */
+    group(prefix, callback) {
+        const combinedPrefix = this.combinePrefixes(this.prefix, prefix);
+        const childGroup = new RouteGroup(combinedPrefix, this.router, this.namedMiddleware, [...this.middlewares]);
+        callback(childGroup);
+        return this;
+    }
+    get(path, ...handlers) {
+        return this.addRoute('GET', path, handlers);
+    }
+    post(path, ...handlers) {
+        return this.addRoute('POST', path, handlers);
+    }
+    put(path, ...handlers) {
+        return this.addRoute('PUT', path, handlers);
+    }
+    patch(path, ...handlers) {
+        return this.addRoute('PATCH', path, handlers);
+    }
+    delete(path, ...handlers) {
+        return this.addRoute('DELETE', path, handlers);
+    }
+    options(path, ...handlers) {
+        return this.addRoute('OPTIONS', path, handlers);
+    }
+    head(path, ...handlers) {
+        return this.addRoute('HEAD', path, handlers);
+    }
+    all(path, ...handlers) {
+        return this.addRoute('ALL', path, handlers);
+    }
+    addRoute(method, path, handlers) {
+        const fullPath = this.combinePrefixes(this.prefix, path);
+        return this.router.add(method, fullPath, [...this.middlewares, ...handlers]);
+    }
+    combinePrefixes(base, sub) {
+        const cleanBase = normalizePath(base);
+        const cleanSub = normalizePath(sub);
+        if (cleanSub === '/') {
+            return cleanBase;
+        }
+        if (cleanBase === '/') {
+            return cleanSub;
+        }
+        return normalizePath(`${cleanBase}/${cleanSub}`);
+    }
+}
+//# sourceMappingURL=route-group.js.map

package/dist/routing/route-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-group.js","sourceRoot":"","sources":["../../src/routing/route-group.ts"],"names":[],"mappings":"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"}

package/dist/scheduler/scheduler.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @file scheduler.ts
+ * @description Cron-based Task Scheduler for AeroJS.
+ * Hospital use: Daily bank reconciliation, BMDC license expiry alerts,
+ * shift auto-close, monthly doctor settlement, dividend calculation trigger.
+ *
+ * Zero external dependency — uses Node.js setInterval with cron expression parsing.
+ */
+export type TaskHandler = () => Promise<void> | void;
+export interface TaskDefinition {
+    name: string;
+    cron: string;
+    handler: TaskHandler;
+    enabled: boolean;
+    description?: string;
+    runOnStart?: boolean;
+    overlap?: boolean;
+}
+export interface TaskRunRecord {
+    name: string;
+    startedAt: Date;
+    finishedAt?: Date;
+    success: boolean;
+    error?: string;
+    durationMs?: number;
+}
+export declare class TaskBuilder {
+    private _cron;
+    private _name;
+    private _description?;
+    private _runOnStart;
+    private _overlap;
+    private manager;
+    constructor(name: string, manager: Scheduler);
+    /** Set cron expression. E.g. '0 23 * * *' = every day at 11PM. */
+    cron(expression: string): this;
+    /** Human-readable description. */
+    description(desc: string): this;
+    /** Run this task immediately when the server starts. */
+    runOnStart(): this;
+    /** Allow the task to overlap if previous run is still in progress. */
+    allowOverlap(): this;
+    /** Register the task with a handler function. */
+    run(handler: TaskHandler): Scheduler;
+}
+export declare class Scheduler {
+    private tasks;
+    private runningTasks;
+    private history;
+    private timer?;
+    private historyLimit;
+    /**
+     * Define a new scheduled task using builder pattern.
+     *
+     * @example
+     * Scheduler.define('DailyBankReco')
+     *   .cron('0 23 * * *')
+     *   .description('Daily bank reconciliation after cashiers close')
+     *   .run(async () => {
+     *     await BankRecoService.runDailyReco();
+     *   });
+     */
+    define(name: string): TaskBuilder;
+    /**
+     * Register a task definition directly.
+     */
+    register(task: TaskDefinition): this;
+    /**
+     * Start the scheduler — checks every minute for tasks to run.
+     * Call this in your server.ts after all tasks are defined.
+     */
+    start(): this;
+    /**
+     * Stop the scheduler (e.g., for graceful shutdown).
+     */
+    stop(): void;
+    private tick;
+    private runTask;
+    getHistory(): TaskRunRecord[];
+    getTasks(): TaskDefinition[];
+    enable(name: string): void;
+    disable(name: string): void;
+}
+export declare const Schedule: Scheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiDH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAY;gBAEf,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS;IAK5C,kEAAkE;IAC3D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKrC,kCAAkC;IAC3B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtC,wDAAwD;IACjD,UAAU,IAAI,IAAI;IAKzB,sEAAsE;IAC/D,YAAY,IAAI,IAAI;IAK3B,iDAAiD;IAC1C,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS;CAa5C;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,KAAK,CAAC,CAAiB;IAC/B,OAAO,CAAC,YAAY,CAAO;IAE3B;;;;;;;;;;OAUG;IACI,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAIxC;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAK3C;;;OAGG;IACI,KAAK,IAAI,IAAI;IA8BpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAQnB,OAAO,CAAC,IAAI;YAaE,OAAO;IA0Bd,UAAU,IAAI,aAAa,EAAE;IAI7B,QAAQ,IAAI,cAAc,EAAE;IAI5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAInC;AAED,eAAO,MAAM,QAAQ,WAAkB,CAAC"}

package/dist/scheduler/scheduler.js

@@ -0,0 +1,216 @@
+/**
+ * @file scheduler.ts
+ * @description Cron-based Task Scheduler for AeroJS.
+ * Hospital use: Daily bank reconciliation, BMDC license expiry alerts,
+ * shift auto-close, monthly doctor settlement, dividend calculation trigger.
+ *
+ * Zero external dependency — uses Node.js setInterval with cron expression parsing.
+ */
+// ─── Cron Parser ──────────────────────────────────────────────────────────────
+/*
+ * Minimal 5-field cron parser.
+ * Fields: minute hour day-of-month month day-of-week
+ * Supports: * (any), numbers, ranges (1-5), step (*\/5), lists (1,3,5)
+ */
+function matchesCronField(value, field) {
+    if (field === '*')
+        return true;
+    // Step: */5
+    if (field.startsWith('*/')) {
+        const step = parseInt(field.slice(2), 10);
+        return value % step === 0;
+    }
+    // List: 1,3,5
+    if (field.includes(',')) {
+        return field.split(',').some((part) => matchesCronField(value, part.trim()));
+    }
+    // Range: 1-5
+    if (field.includes('-')) {
+        const [start, end] = field.split('-').map(Number);
+        return value >= start && value <= end;
+    }
+    return value === parseInt(field, 10);
+}
+function shouldRunNow(cron, now = new Date()) {
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length !== 5)
+        throw new Error(`Invalid cron expression: "${cron}"`);
+    const [minute, hour, dayOfMonth, month, dayOfWeek] = parts;
+    return (matchesCronField(now.getMinutes(), minute) &&
+        matchesCronField(now.getHours(), hour) &&
+        matchesCronField(now.getDate(), dayOfMonth) &&
+        matchesCronField(now.getMonth() + 1, month) &&
+        matchesCronField(now.getDay(), dayOfWeek));
+}
+// ─── Scheduler Builder ────────────────────────────────────────────────────────
+export class TaskBuilder {
+    _cron = '';
+    _name;
+    _description;
+    _runOnStart = false;
+    _overlap = false;
+    manager;
+    constructor(name, manager) {
+        this._name = name;
+        this.manager = manager;
+    }
+    /** Set cron expression. E.g. '0 23 * * *' = every day at 11PM. */
+    cron(expression) {
+        this._cron = expression;
+        return this;
+    }
+    /** Human-readable description. */
+    description(desc) {
+        this._description = desc;
+        return this;
+    }
+    /** Run this task immediately when the server starts. */
+    runOnStart() {
+        this._runOnStart = true;
+        return this;
+    }
+    /** Allow the task to overlap if previous run is still in progress. */
+    allowOverlap() {
+        this._overlap = true;
+        return this;
+    }
+    /** Register the task with a handler function. */
+    run(handler) {
+        if (!this._cron)
+            throw new Error(`[AeroJS Scheduler] Task "${this._name}" has no cron expression. Call .cron('...')`);
+        this.manager.register({
+            name: this._name,
+            cron: this._cron,
+            handler,
+            enabled: true,
+            description: this._description,
+            runOnStart: this._runOnStart,
+            overlap: this._overlap,
+        });
+        return this.manager;
+    }
+}
+// ─── Scheduler ────────────────────────────────────────────────────────────────
+export class Scheduler {
+    tasks = new Map();
+    runningTasks = new Set();
+    history = [];
+    timer;
+    historyLimit = 500;
+    /**
+     * Define a new scheduled task using builder pattern.
+     *
+     * @example
+     * Scheduler.define('DailyBankReco')
+     *   .cron('0 23 * * *')
+     *   .description('Daily bank reconciliation after cashiers close')
+     *   .run(async () => {
+     *     await BankRecoService.runDailyReco();
+     *   });
+     */
+    define(name) {
+        return new TaskBuilder(name, this);
+    }
+    /**
+     * Register a task definition directly.
+     */
+    register(task) {
+        this.tasks.set(task.name, task);
+        return this;
+    }
+    /**
+     * Start the scheduler — checks every minute for tasks to run.
+     * Call this in your server.ts after all tasks are defined.
+     */
+    start() {
+        if (this.timer) {
+            console.warn('[AeroJS Scheduler] Scheduler is already running');
+            return this;
+        }
+        // Run on-start tasks
+        for (const task of this.tasks.values()) {
+            if (task.runOnStart && task.enabled) {
+                setImmediate(() => this.runTask(task));
+            }
+        }
+        // Schedule minute-by-minute checks
+        this.timer = setInterval(() => {
+            this.tick(new Date());
+        }, 60 * 1000);
+        // Align to the next minute boundary
+        const now = new Date();
+        const msUntilNextMinute = (60 - now.getSeconds()) * 1000 - now.getMilliseconds();
+        setTimeout(() => {
+            this.tick(new Date());
+            this.timer = setInterval(() => this.tick(new Date()), 60 * 1000);
+        }, msUntilNextMinute);
+        console.info('[AeroJS Scheduler] Started — tick every 60 seconds');
+        return this;
+    }
+    /**
+     * Stop the scheduler (e.g., for graceful shutdown).
+     */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+            console.info('[AeroJS Scheduler] Stopped');
+        }
+    }
+    tick(now) {
+        for (const task of this.tasks.values()) {
+            if (!task.enabled)
+                continue;
+            if (shouldRunNow(task.cron, now)) {
+                if (!task.overlap && this.runningTasks.has(task.name)) {
+                    console.warn(`[AeroJS Scheduler] Task "${task.name}" is still running from previous tick — skipping`);
+                    continue;
+                }
+                this.runTask(task);
+            }
+        }
+    }
+    async runTask(task) {
+        this.runningTasks.add(task.name);
+        const record = {
+            name: task.name,
+            startedAt: new Date(),
+            success: false,
+        };
+        try {
+            await task.handler();
+            record.success = true;
+        }
+        catch (err) {
+            record.error = err?.message ?? String(err);
+            console.error(`[AeroJS Scheduler] Task "${task.name}" failed:`, err);
+        }
+        finally {
+            record.finishedAt = new Date();
+            record.durationMs = record.finishedAt.getTime() - record.startedAt.getTime();
+            this.runningTasks.delete(task.name);
+            this.history.push(record);
+            if (this.history.length > this.historyLimit) {
+                this.history = this.history.slice(-this.historyLimit);
+            }
+        }
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    getTasks() {
+        return Array.from(this.tasks.values());
+    }
+    enable(name) {
+        const task = this.tasks.get(name);
+        if (task)
+            task.enabled = true;
+    }
+    disable(name) {
+        const task = this.tasks.get(name);
+        if (task)
+            task.enabled = false;
+    }
+}
+export const Schedule = new Scheduler();
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":"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"}

package/dist/security/csrf.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file csrf.ts
+ * @description Zero-dependency CSRF protection middleware for Aero using cryptographic tokens.
+ */
+import type { Middleware } from '../core/types.js';
+export interface CsrfOptions {
+    secret?: string;
+    cookieName?: string;
+    headerName?: string;
+    cookieOptions?: {
+        httpOnly?: boolean;
+        sameSite?: 'strict' | 'lax' | 'none';
+        path?: string;
+        secure?: boolean;
+    };
+    ignoredMethods?: string[];
+}
+export declare function csrf(options?: CsrfOptions): Middleware;
+//# sourceMappingURL=csrf.d.ts.map

package/dist/security/csrf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csrf.d.ts","sourceRoot":"","sources":["../../src/security/csrf.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAC;AAIjE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;QACrC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AA4BD,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CA8C1D"}

package/dist/security/csrf.js

@@ -0,0 +1,69 @@
+/**
+ * @file csrf.ts
+ * @description Zero-dependency CSRF protection middleware for Aero using cryptographic tokens.
+ */
+import crypto from 'node:crypto';
+import { ForbiddenError } from '../core/errors.js';
+function timingSafeEqual(a, b) {
+    const bufA = Buffer.from(a, 'utf-8');
+    const bufB = Buffer.from(b, 'utf-8');
+    if (bufA.length !== bufB.length) {
+        return false;
+    }
+    return crypto.timingSafeEqual(bufA, bufB);
+}
+function generateToken(secret) {
+    const raw = crypto.randomBytes(32).toString('hex');
+    if (!secret)
+        return raw;
+    const sig = crypto.createHmac('sha256', secret).update(raw).digest('hex');
+    return `${raw}.${sig}`;
+}
+function verifyTokenSignature(token, secret) {
+    if (!secret)
+        return true;
+    const dotIndex = token.indexOf('.');
+    if (dotIndex === -1)
+        return false;
+    const raw = token.slice(0, dotIndex);
+    const sig = token.slice(dotIndex + 1);
+    const expected = crypto.createHmac('sha256', secret).update(raw).digest('hex');
+    return timingSafeEqual(sig, expected);
+}
+export function csrf(options = {}) {
+    const cookieName = options.cookieName || '_csrf';
+    const headerName = (options.headerName || 'x-csrf-token').toLowerCase();
+    const ignoredMethods = new Set(options.ignoredMethods || ['GET', 'HEAD', 'OPTIONS']);
+    const cookieOpts = {
+        httpOnly: false, // Must be readable by client JS for SPAs/forms unless using double-submit
+        sameSite: 'lax',
+        path: '/',
+        ...options.cookieOptions,
+    };
+    return async (ctx, next) => {
+        let token = ctx.cookies[cookieName];
+        if (!token || (options.secret && !verifyTokenSignature(token, options.secret))) {
+            token = generateToken(options.secret);
+            ctx.res.setCookie(cookieName, token, cookieOpts);
+        }
+        // Attach csrfToken generator/getter to ctx
+        ctx.csrfToken = () => token;
+        // Validate safe methods
+        if (ignoredMethods.has(ctx.method)) {
+            return next();
+        }
+        // Check incoming token from header or body
+        const headerToken = ctx.req.get(headerName);
+        const bodyToken = typeof ctx.body === 'object' && ctx.body !== null
+            ? ctx.body['_csrf'] || ctx.body['csrf_token']
+            : undefined;
+        const providedToken = (headerToken || (typeof bodyToken === 'string' ? bodyToken : undefined));
+        if (!providedToken ||
+            !timingSafeEqual(token, providedToken) ||
+            (options.secret && !verifyTokenSignature(providedToken, options.secret))) {
+            throw new ForbiddenError('Invalid or missing CSRF token');
+        }
+        await next();
+    };
+}
+//# sourceMappingURL=csrf.js.map

package/dist/security/csrf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csrf.js","sourceRoot":"","sources":["../../src/security/csrf.ts"],"names":[],"mappings":"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"}

package/dist/security/hash.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file hash.ts
+ * @description Zero-dependency, memory-hard Password Hashing & Verification Engine (scrypt) for AeroJS.
+ * Powered by Node.js built-in `node:crypto`. Implements OWASP-recommended parameters and timing-safe comparison.
+ */
+export interface ScryptOptions {
+    N?: number;
+    r?: number;
+    p?: number;
+    keyLen?: number;
+    saltLen?: number;
+}
+export declare class Hash {
+    private static defaultOptions;
+    /**
+     * Hashes a plaintext password using crypto.scrypt with a cryptographically secure random salt.
+     */
+    static make(password: string, options?: ScryptOptions): Promise<string>;
+    /**
+     * Verifies a plaintext password against a stored scrypt hash using constant-time timingSafeEqual.
+     */
+    static verify(hash: string, password: string): Promise<boolean>;
+    /**
+     * Checks if the given hash needs to be rehashed with updated work factors.
+     */
+    static needsRehash(hash: string, options?: ScryptOptions): boolean;
+}
+export declare const hash: (password: string, options?: ScryptOptions) => Promise<string>;
+export declare const hashVerify: (hashStr: string, password: string) => Promise<boolean>;
+//# sourceMappingURL=hash.d.ts.map

package/dist/security/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/security/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,aAAa;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,IAAI;IACf,OAAO,CAAC,MAAM,CAAC,cAAc,CAM3B;IAEF;;OAEG;WACiB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBxF;;OAEG;WACiB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyC5E;;OAEG;WACW,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO;CAW9E;AAED,eAAO,MAAM,IAAI,GAAI,UAAU,MAAM,EAAE,UAAU,aAAa,oBAAiC,CAAC;AAChG,eAAO,MAAM,UAAU,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,qBAAmC,CAAC"}