@shohaghinfo/aerojs 0.1.0

package/dist/inertia/inertia.js

@@ -0,0 +1,159 @@
+/**
+ * @file inertia.ts
+ * @description Official Inertia.js protocol adapter for Aero supporting React and Vue 3.
+ */
+import { SSREngine } from '../ssr/engine.js';
+/**
+ * Creates a lazy-evaluated prop that is only computed during partial reloads.
+ */
+export function lazy(fn) {
+    return async () => fn();
+}
+/**
+ * Inertia.js Context wrapper attached to each request via ctx.inertia.
+ */
+export class Inertia {
+    ctx;
+    sharedProps = new Map();
+    version;
+    rootView;
+    ssrEngine;
+    constructor(ctx, config = {}) {
+        this.ctx = ctx;
+        this.version = typeof config.version === 'function' ? String(config.version()) : config.version ?? '1.0';
+        if (config.ssr) {
+            if (typeof config.ssr === 'function') {
+                this.ssrEngine = new SSREngine({ render: config.ssr });
+            }
+            else if (typeof config.ssr === 'object') {
+                this.ssrEngine = new SSREngine(config.ssr);
+            }
+            else {
+                this.ssrEngine = new SSREngine();
+            }
+        }
+        if (typeof config.rootView === 'function') {
+            this.rootView = config.rootView;
+        }
+        else {
+            const template = config.rootView ?? this.defaultHtmlTemplate();
+            this.rootView = async (page) => {
+                if (this.ssrEngine) {
+                    const rendered = await this.ssrEngine.render(page);
+                    return rendered.html;
+                }
+                const escaped = JSON.stringify(page)
+                    .replace(/&/g, '&')
+                    .replace(/</g, '&lt;')
+                    .replace(/>/g, '&gt;')
+                    .replace(/"/g, '&quot;')
+                    .replace(/'/g, '&#039;');
+                return template.replace(/@inertia|<!-- @inertia -->|<div id="app"><\/div>/, `<div id="app" data-page="${escaped}"></div>`);
+            };
+        }
+    }
+    share(keyOrProps, value) {
+        if (typeof keyOrProps === 'string') {
+            this.sharedProps.set(keyOrProps, value);
+        }
+        else if (typeof keyOrProps === 'object' && keyOrProps !== null) {
+            for (const [k, v] of Object.entries(keyOrProps)) {
+                this.sharedProps.set(k, v);
+            }
+        }
+        return this;
+    }
+    /**
+     * Renders an Inertia component with props, automatically handling initial HTML
+     * loads or subsequent X-Inertia JSON requests.
+     */
+    async render(component, props = {}) {
+        const isInertia = this.ctx.req.get('x-inertia') === 'true';
+        const clientVersion = this.ctx.req.get('x-inertia-version');
+        // 1. Asset version mismatch check on GET requests
+        if (isInertia && this.ctx.method === 'GET' && clientVersion && clientVersion !== this.version) {
+            this.ctx.status(409).set('X-Inertia-Location', this.ctx.req.url).send(null);
+            return;
+        }
+        // 2. Resolve partial reload keys if specified
+        const partialComponent = this.ctx.req.get('x-inertia-partial-component');
+        const partialData = this.ctx.req.get('x-inertia-partial-data');
+        const isPartial = isInertia && partialComponent === component && Boolean(partialData);
+        const partialKeys = isPartial ? partialData.split(',').map((k) => k.trim()) : null;
+        // 3. Resolve shared and route-specific props
+        const allRawProps = {
+            ...Object.fromEntries(this.sharedProps),
+            ...props,
+        };
+        const resolvedProps = {};
+        for (const [key, val] of Object.entries(allRawProps)) {
+            if (partialKeys && !partialKeys.includes(key)) {
+                continue;
+            }
+            if (typeof val === 'function') {
+                resolvedProps[key] = await val();
+            }
+            else {
+                resolvedProps[key] = val;
+            }
+        }
+        const page = {
+            component,
+            props: resolvedProps,
+            url: this.ctx.req.url,
+            version: this.version,
+        };
+        // 4. Return JSON for Inertia AJAX requests, or full HTML shell for first visits
+        if (isInertia) {
+            this.ctx.set('X-Inertia', 'true');
+            this.ctx.set('Vary', 'Accept');
+            this.ctx.status(200).json(page);
+        }
+        else {
+            const html = await this.rootView(page);
+            this.ctx.html(html);
+        }
+    }
+    /**
+     * Issues an Inertia-compatible redirect (using 303 See Other on PUT/PATCH/DELETE).
+     */
+    redirect(url) {
+        const method = this.ctx.method;
+        const status = ['PUT', 'PATCH', 'DELETE'].includes(method) ? 303 : 302;
+        this.ctx.redirect(url, status);
+    }
+    /**
+     * Client-side hard redirect for external URLs or version conflicts.
+     */
+    location(url) {
+        if (this.ctx.req.get('x-inertia') === 'true') {
+            this.ctx.status(409).set('X-Inertia-Location', url).send(null);
+        }
+        else {
+            this.ctx.redirect(url);
+        }
+    }
+    defaultHtmlTemplate() {
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Aero App</title>
+</head>
+<body>
+  @inertia
+</body>
+</html>`;
+    }
+}
+/**
+ * Creates an Inertia.js middleware attaching `ctx.inertia` to every request.
+ */
+export function inertiaPlugin(config = {}) {
+    return async (ctx, next) => {
+        ctx.inertia = new Inertia(ctx, config);
+        await next();
+    };
+}
+//# sourceMappingURL=inertia.js.map

package/dist/inertia/inertia.js.map

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

package/dist/logging/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file index.ts
+ * @description Logging and Request Context modules for AeroJS.
+ */
+export { Logger, requestLogger, type LogLevel } from './logger.js';
+export { RequestContext, type RequestStore } from './request-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,7 @@
+/**
+ * @file index.ts
+ * @description Logging and Request Context modules for AeroJS.
+ */
+export { Logger, requestLogger } from './logger.js';
+export { RequestContext } from './request-context.js';
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAiB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,cAAc,EAAqB,MAAM,sBAAsB,CAAC"}

package/dist/logging/logger.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @file logger.ts
+ * @description Advanced Structured Logging System for AeroJS modeled after RFC 5424.
+ * Includes RequestContext correlation, slow query detection, security auditing, and file stream rotation.
+ */
+import type { Middleware } from '../core/types.js';
+export type LogLevel = 'emergency' | 'alert' | 'critical' | 'error' | 'warning' | 'notice' | 'info' | 'debug';
+export declare class Logger {
+    static EMERGENCY: LogLevel;
+    static ALERT: LogLevel;
+    static CRITICAL: LogLevel;
+    static ERROR: LogLevel;
+    static WARNING: LogLevel;
+    static NOTICE: LogLevel;
+    static INFO: LogLevel;
+    static DEBUG: LogLevel;
+    static logFile: string;
+    static errorLogFile: string;
+    static enableFileLogging: boolean;
+    static enableConsoleLogging: boolean;
+    static slowQueryThresholdMs: number;
+    static levels: Record<LogLevel, number>;
+    /**
+     * Initialize logging directories if file logging is enabled
+     */
+    static init(): void;
+    static emergency(message: string, context?: Record<string, unknown>): void;
+    static alert(message: string, context?: Record<string, unknown>): void;
+    static critical(message: string, context?: Record<string, unknown>): void;
+    static error(message: string, context?: Record<string, unknown>): void;
+    static warning(message: string, context?: Record<string, unknown>): void;
+    static warn(message: string, context?: Record<string, unknown>): void;
+    static notice(message: string, context?: Record<string, unknown>): void;
+    static info(message: string, context?: Record<string, unknown>): void;
+    static debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Core logging method
+     */
+    static log(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    /**
+     * Logs a database query with duration and slow query detection.
+     */
+    static logQuery(query: string, bindings?: unknown[], executionTimeMs?: number | null): void;
+    /**
+     * Logs user activity and audit trail.
+     */
+    static logActivity(action: string, details?: Record<string, unknown>): void;
+    /**
+     * Logs security events (authentication failures, CSRF breaches, rate limit hits).
+     */
+    static logSecurity(event: string, details?: Record<string, unknown>): void;
+    /**
+     * Reads recent log lines from disk.
+     */
+    static getRecentLogs(lines?: number, file?: string | null): string[];
+}
+/**
+ * Middleware that wraps requests in a RequestContext store and logs request lifecycle metrics.
+ */
+export declare function requestLogger(): Middleware;
+export default Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,OAAO,GACP,UAAU,GACV,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,GACN,OAAO,CAAC;AAEZ,qBAAa,MAAM;IACjB,OAAc,SAAS,EAAE,QAAQ,CAAe;IAChD,OAAc,KAAK,EAAE,QAAQ,CAAW;IACxC,OAAc,QAAQ,EAAE,QAAQ,CAAc;IAC9C,OAAc,KAAK,EAAE,QAAQ,CAAW;IACxC,OAAc,OAAO,EAAE,QAAQ,CAAa;IAC5C,OAAc,MAAM,EAAE,QAAQ,CAAY;IAC1C,OAAc,IAAI,EAAE,QAAQ,CAAU;IACtC,OAAc,KAAK,EAAE,QAAQ,CAAW;IAExC,OAAc,OAAO,SAA0B;IAC/C,OAAc,YAAY,SAA4B;IACtD,OAAc,iBAAiB,UAAS;IACxC,OAAc,oBAAoB,UAAQ;IAC1C,OAAc,oBAAoB,SAAO;IAEzC,OAAc,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAS5C;IAEF;;OAEG;WACW,IAAI,IAAI,IAAI;WAQZ,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAIvE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAInE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAItE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAInE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAIrE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAIlE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAIpE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;WAIlE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAIjF;;OAEG;WACW,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAmDhG;;OAEG;WACW,QAAQ,CACpB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,OAAO,EAAO,EACxB,eAAe,GAAE,MAAM,GAAG,IAAW,GACpC,IAAI;IASP;;OAEG;WACW,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAatF;;OAEG;WACW,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAQrF;;OAEG;WACW,aAAa,CAAC,KAAK,SAAK,EAAE,IAAI,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,EAAE;CAU9E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAoB1C;AAED,eAAe,MAAM,CAAC"}

package/dist/logging/logger.js

@@ -0,0 +1,197 @@
+/**
+ * @file logger.ts
+ * @description Advanced Structured Logging System for AeroJS modeled after RFC 5424.
+ * Includes RequestContext correlation, slow query detection, security auditing, and file stream rotation.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { RequestContext } from './request-context.js';
+export class Logger {
+    static EMERGENCY = 'emergency';
+    static ALERT = 'alert';
+    static CRITICAL = 'critical';
+    static ERROR = 'error';
+    static WARNING = 'warning';
+    static NOTICE = 'notice';
+    static INFO = 'info';
+    static DEBUG = 'debug';
+    static logFile = 'storage/logs/app.log';
+    static errorLogFile = 'storage/logs/error.log';
+    static enableFileLogging = false; // Enabled when log file directory exists or configured
+    static enableConsoleLogging = true;
+    static slowQueryThresholdMs = 100;
+    static levels = {
+        emergency: 0,
+        alert: 1,
+        critical: 2,
+        error: 3,
+        warning: 4,
+        notice: 5,
+        info: 6,
+        debug: 7,
+    };
+    /**
+     * Initialize logging directories if file logging is enabled
+     */
+    static init() {
+        if (!this.enableFileLogging)
+            return;
+        const baseDir = path.dirname(path.resolve(this.logFile));
+        if (!fs.existsSync(baseDir)) {
+            fs.mkdirSync(baseDir, { recursive: true });
+        }
+    }
+    static emergency(message, context = {}) {
+        this.log(this.EMERGENCY, message, context);
+    }
+    static alert(message, context = {}) {
+        this.log(this.ALERT, message, context);
+    }
+    static critical(message, context = {}) {
+        this.log(this.CRITICAL, message, context);
+    }
+    static error(message, context = {}) {
+        this.log(this.ERROR, message, context);
+    }
+    static warning(message, context = {}) {
+        this.log(this.WARNING, message, context);
+    }
+    static warn(message, context = {}) {
+        this.log(this.WARNING, message, context);
+    }
+    static notice(message, context = {}) {
+        this.log(this.NOTICE, message, context);
+    }
+    static info(message, context = {}) {
+        this.log(this.INFO, message, context);
+    }
+    static debug(message, context = {}) {
+        this.log(this.DEBUG, message, context);
+    }
+    /**
+     * Core logging method
+     */
+    static log(level, message, context = {}) {
+        const timestamp = new Date().toISOString().replace('T', ' ').substring(0, 19);
+        // Resolve context from RequestContext (AsyncLocalStorage)
+        const store = RequestContext.getStore();
+        let ip = '127.0.0.1';
+        let userId = 'guest';
+        let requestPath = 'CLI';
+        if (store?.ctx) {
+            const ctx = store.ctx;
+            ip = ctx.req.ip || '127.0.0.1';
+            userId = ctx.state?.user?.id || ctx.state?.user || 'guest';
+            requestPath = `${ctx.method} ${ctx.path}`;
+        }
+        const cleanContext = { ...context };
+        const contextStr = Object.keys(cleanContext).length === 0
+            ? ''
+            : ' | Context: ' + JSON.stringify(cleanContext);
+        const logEntry = `[${timestamp}] ${level.toUpperCase()} | IP: ${ip} | User: ${userId} | ${requestPath}: ${message}${contextStr}`;
+        // 1. Console Output
+        if (this.enableConsoleLogging) {
+            if (['emergency', 'alert', 'critical', 'error'].includes(level)) {
+                console.error(`\x1b[31m${logEntry}\x1b[0m`);
+            }
+            else if (level === 'warning') {
+                console.warn(`\x1b[33m${logEntry}\x1b[0m`);
+            }
+            else if (level === 'debug') {
+                console.debug(`\x1b[90m${logEntry}\x1b[0m`);
+            }
+            else {
+                console.log(`\x1b[36m${logEntry}\x1b[0m`);
+            }
+        }
+        // 2. File Output (if enabled)
+        if (this.enableFileLogging) {
+            this.init();
+            const isErrorLog = ['emergency', 'alert', 'critical', 'error'].includes(level);
+            const targetFile = isErrorLog ? this.errorLogFile : this.logFile;
+            try {
+                fs.appendFileSync(targetFile, logEntry + '\n', 'utf8');
+            }
+            catch (err) {
+                console.error('Failed to write log to file:', err);
+            }
+        }
+    }
+    /**
+     * Logs a database query with duration and slow query detection.
+     */
+    static logQuery(query, bindings = [], executionTimeMs = null) {
+        const context = { query, bindings, execution_time_ms: executionTimeMs };
+        if (executionTimeMs !== null && executionTimeMs >= this.slowQueryThresholdMs) {
+            this.warning(`Slow query detected (${executionTimeMs}ms)`, context);
+        }
+        else {
+            this.debug('Database query executed', context);
+        }
+    }
+    /**
+     * Logs user activity and audit trail.
+     */
+    static logActivity(action, details = {}) {
+        const store = RequestContext.getStore();
+        const userAgent = store?.ctx?.req.get('user-agent') || 'Unknown';
+        const referer = store?.ctx?.req.get('referer') || 'Direct';
+        this.info(`User activity: ${action}`, {
+            ...details,
+            action,
+            user_agent: userAgent,
+            referer,
+        });
+    }
+    /**
+     * Logs security events (authentication failures, CSRF breaches, rate limit hits).
+     */
+    static logSecurity(event, details = {}) {
+        this.warning(`Security event: ${event}`, {
+            ...details,
+            event,
+            severity: 'high',
+        });
+    }
+    /**
+     * Reads recent log lines from disk.
+     */
+    static getRecentLogs(lines = 50, file = null) {
+        const filePath = file || this.logFile;
+        if (!fs.existsSync(filePath)) {
+            return [];
+        }
+        const content = fs.readFileSync(filePath, 'utf8');
+        const logsArray = content.split('\n').filter((l) => l.trim().length > 0);
+        return logsArray.reverse().slice(0, lines);
+    }
+}
+/**
+ * Middleware that wraps requests in a RequestContext store and logs request lifecycle metrics.
+ */
+export function requestLogger() {
+    return async (ctx, next) => {
+        const start = Date.now();
+        await RequestContext.run({ ctx }, async () => {
+            try {
+                await next();
+            }
+            finally {
+                const duration = Date.now() - start;
+                const status = ctx.res.statusCode;
+                const msg = `${ctx.method} ${ctx.path} -> ${status} (${duration}ms)`;
+                if (status >= 500) {
+                    Logger.error(msg);
+                }
+                else if (status >= 400) {
+                    Logger.warning(msg);
+                }
+                else {
+                    Logger.info(msg);
+                }
+            }
+        });
+    };
+}
+export default Logger;
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

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

package/dist/logging/request-context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file request-context.ts
+ * @description Global Request Context tracking using Node.js AsyncLocalStorage.
+ * Allows models, services, and loggers to access the active HTTP context without manual prop-drilling.
+ */
+import type { AeroContext } from '../core/context.js';
+export interface RequestStore {
+    ctx: AeroContext<any>;
+    requestId?: string;
+    user?: any;
+    [key: string]: any;
+}
+export declare class RequestContext {
+    private static storage;
+    /**
+     * Run a function within an asynchronous request context.
+     */
+    static run<R>(store: RequestStore, callback: () => R): R;
+    /**
+     * Get the active request store, or undefined if outside a request lifecycle.
+     */
+    static getStore(): RequestStore | undefined;
+    /**
+     * Get the current AeroContext, if available.
+     */
+    static currentContext(): AeroContext<any> | undefined;
+}
+export default RequestContext;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/logging/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/logging/request-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAyC;IAE/D;;OAEG;WACW,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC;IAI/D;;OAEG;WACW,QAAQ,IAAI,YAAY,GAAG,SAAS;IAIlD;;OAEG;WACW,cAAc,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS;CAG7D;AAED,eAAe,cAAc,CAAC"}

package/dist/logging/request-context.js

@@ -0,0 +1,29 @@
+/**
+ * @file request-context.ts
+ * @description Global Request Context tracking using Node.js AsyncLocalStorage.
+ * Allows models, services, and loggers to access the active HTTP context without manual prop-drilling.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+export class RequestContext {
+    static storage = new AsyncLocalStorage();
+    /**
+     * Run a function within an asynchronous request context.
+     */
+    static run(store, callback) {
+        return this.storage.run(store, callback);
+    }
+    /**
+     * Get the active request store, or undefined if outside a request lifecycle.
+     */
+    static getStore() {
+        return this.storage.getStore();
+    }
+    /**
+     * Get the current AeroContext, if available.
+     */
+    static currentContext() {
+        return this.storage.getStore()?.ctx;
+    }
+}
+export default RequestContext;
+//# sourceMappingURL=request-context.js.map

package/dist/logging/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/logging/request-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAUrD,MAAM,OAAO,cAAc;IACjB,MAAM,CAAC,OAAO,GAAG,IAAI,iBAAiB,EAAgB,CAAC;IAE/D;;OAEG;IACI,MAAM,CAAC,GAAG,CAAI,KAAmB,EAAE,QAAiB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,cAAc;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC;IACtC,CAAC;;AAGH,eAAe,cAAc,CAAC"}

package/dist/mail/drivers/log-mail-driver.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @file log-mail-driver.ts
+ * @description Log mail driver for AeroJS.
+ * Logs email content to console/file via Aero RFC 5424 Logger without sending real emails.
+ */
+import type { MailDriver, SentMailResult } from './mail-driver.js';
+import type { MailMessage } from '../message.js';
+export declare class LogMailDriver implements MailDriver {
+    send(message: MailMessage): Promise<SentMailResult>;
+}
+//# sourceMappingURL=log-mail-driver.d.ts.map

package/dist/mail/drivers/log-mail-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-mail-driver.d.ts","sourceRoot":"","sources":["../../../src/mail/drivers/log-mail-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,qBAAa,aAAc,YAAW,UAAU;IACjC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAejE"}

package/dist/mail/drivers/log-mail-driver.js

@@ -0,0 +1,23 @@
+/**
+ * @file log-mail-driver.ts
+ * @description Log mail driver for AeroJS.
+ * Logs email content to console/file via Aero RFC 5424 Logger without sending real emails.
+ */
+import { Logger } from '../../logging/logger.js';
+export class LogMailDriver {
+    async send(message) {
+        Logger.info(`[MAIL] Outgoing Email: "${message.subjectLine}"`, {
+            to: message.toAddresses,
+            from: message.fromAddress,
+            subject: message.subjectLine,
+            text: message.textBody,
+        });
+        const messageId = `<${Date.now()}.log@aerojs.org>`;
+        return {
+            messageId,
+            accepted: [...message.toAddresses],
+            rejected: [],
+        };
+    }
+}
+//# sourceMappingURL=log-mail-driver.js.map

package/dist/mail/drivers/log-mail-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-mail-driver.js","sourceRoot":"","sources":["../../../src/mail/drivers/log-mail-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,MAAM,OAAO,aAAa;IACjB,KAAK,CAAC,IAAI,CAAC,OAAoB;QACpC,MAAM,CAAC,IAAI,CAAC,2BAA2B,OAAO,CAAC,WAAW,GAAG,EAAE;YAC7D,EAAE,EAAE,OAAO,CAAC,WAAW;YACvB,IAAI,EAAE,OAAO,CAAC,WAAW;YACzB,OAAO,EAAE,OAAO,CAAC,WAAW;YAC5B,IAAI,EAAE,OAAO,CAAC,QAAQ;SACvB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC;QACnD,OAAO;YACL,SAAS;YACT,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;YAClC,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;CACF"}

package/dist/mail/drivers/mail-driver.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file mail-driver.ts
+ * @description MailDriver interface for email dispatch adapters in AeroJS.
+ */
+import type { MailMessage } from '../message.js';
+export interface SentMailResult {
+    messageId: string;
+    accepted: string[];
+    rejected: string[];
+}
+export interface MailDriver {
+    send(message: MailMessage): Promise<SentMailResult>;
+}
+//# sourceMappingURL=mail-driver.d.ts.map

package/dist/mail/drivers/mail-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-driver.d.ts","sourceRoot":"","sources":["../../../src/mail/drivers/mail-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACrD"}

package/dist/mail/drivers/mail-driver.js

@@ -0,0 +1,6 @@
+/**
+ * @file mail-driver.ts
+ * @description MailDriver interface for email dispatch adapters in AeroJS.
+ */
+export {};
+//# sourceMappingURL=mail-driver.js.map

package/dist/mail/drivers/mail-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-driver.js","sourceRoot":"","sources":["../../../src/mail/drivers/mail-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/mail/drivers/memory-mail-driver.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file memory-mail-driver.ts
+ * @description In-memory mail driver for AeroJS.
+ * Records all dispatched messages in memory for unit testing, inspection, and assertions.
+ */
+import type { MailDriver, SentMailResult } from './mail-driver.js';
+import type { MailMessage } from '../message.js';
+export declare class MemoryMailDriver implements MailDriver {
+    sentMessages: MailMessage[];
+    send(message: MailMessage): Promise<SentMailResult>;
+    get last(): MailMessage | undefined;
+    clear(): void;
+}
+//# sourceMappingURL=memory-mail-driver.d.ts.map

package/dist/mail/drivers/memory-mail-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-mail-driver.d.ts","sourceRoot":"","sources":["../../../src/mail/drivers/memory-mail-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,gBAAiB,YAAW,UAAU;IAC1C,YAAY,EAAE,WAAW,EAAE,CAAM;IAE3B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAUhE,IAAW,IAAI,IAAI,WAAW,GAAG,SAAS,CAEzC;IAEM,KAAK,IAAI,IAAI;CAGrB"}