@shohaghinfo/aerojs 0.1.0

package/dist/session/session-manager.js

@@ -0,0 +1,186 @@
+/**
+ * @file session-manager.ts
+ * @description Server-side Session Manager for AeroJS.
+ * Provides a clean API for reading/writing session data per HTTP request.
+ * Hospital use: Cashier shift sessions, CSRF tokens, flash messages, terminal binding.
+ */
+import crypto from 'node:crypto';
+import { MemorySessionDriver } from './session-driver.js';
+/**
+ * Per-request Session Manager.
+ * Loaded lazily from the driver on first access, written back at response end.
+ */
+export class SessionManager {
+    sessionId;
+    data = {};
+    _loaded = false;
+    _dirty = false;
+    driver;
+    config;
+    ctx;
+    constructor(ctx, sessionId, config) {
+        this.ctx = ctx;
+        this.sessionId = sessionId;
+        this.driver = config.driver;
+        this.config = config;
+    }
+    /**
+     * Lazily load session data from the driver.
+     */
+    async ensureLoaded() {
+        if (this._loaded)
+            return;
+        this.data = await this.driver.read(this.sessionId);
+        this._loaded = true;
+    }
+    /** Get a session value. */
+    async get(key) {
+        await this.ensureLoaded();
+        return this.data[key];
+    }
+    /** Get all session data. */
+    async all() {
+        await this.ensureLoaded();
+        return { ...this.data };
+    }
+    /** Set a session value. */
+    async put(key, value) {
+        await this.ensureLoaded();
+        this.data[key] = value;
+        this._dirty = true;
+    }
+    /** Check if a session key exists. */
+    async has(key) {
+        await this.ensureLoaded();
+        return Object.prototype.hasOwnProperty.call(this.data, key);
+    }
+    /** Remove a session key. */
+    async forget(key) {
+        await this.ensureLoaded();
+        delete this.data[key];
+        this._dirty = true;
+    }
+    /** Clear all session data. */
+    async flush() {
+        await this.ensureLoaded();
+        this.data = {};
+        this._dirty = true;
+    }
+    /**
+     * Set or get a flash message (single-use — removed on next request).
+     * Hospital use: "Shift closed successfully" message after cashier close.
+     */
+    async flash(key, value) {
+        await this.ensureLoaded();
+        if (value !== undefined) {
+            this.data[`__flash_${key}`] = value;
+            this._dirty = true;
+            return value;
+        }
+        const flashKey = `__flash_${key}`;
+        const val = this.data[flashKey];
+        delete this.data[flashKey];
+        if (val !== undefined)
+            this._dirty = true;
+        return val;
+    }
+    /**
+     * Update session lifetime for "remember me" functionality.
+     */
+    async setExpiry(_seconds) {
+        // Lifetime is applied at commit time via the driver TTL
+        // Override is not supported after construction — set lifetime in SessionConfig
+    }
+    /**
+     * Regenerate session ID to prevent session fixation attacks.
+     * Call this after login and logout.
+     */
+    async regenerate() {
+        await this.ensureLoaded();
+        // Destroy old session
+        await this.driver.destroy(this.sessionId);
+        // Generate new session ID
+        this.sessionId = crypto.randomBytes(32).toString('hex');
+        // Write data under new ID
+        await this.driver.write(this.sessionId, this.data, this.config.lifetime);
+        this._dirty = false;
+        // Update cookie
+        this.writeSessionCookie();
+    }
+    /**
+     * Destroy the current session completely.
+     */
+    async destroy() {
+        await this.driver.destroy(this.sessionId);
+        this.data = {};
+        this._loaded = false;
+        this._dirty = false;
+        // Clear session cookie
+        this.ctx.clearCookie(this.config.cookieName);
+    }
+    /**
+     * Persist session data to driver (called automatically at end of request).
+     */
+    async commit() {
+        if (!this._dirty && !this._loaded)
+            return;
+        await this.ensureLoaded();
+        await this.driver.write(this.sessionId, this.data, this.config.lifetime);
+        this.writeSessionCookie();
+        this._dirty = false;
+    }
+    writeSessionCookie() {
+        this.ctx.cookie(this.config.cookieName, this.sessionId, {
+            httpOnly: this.config.cookie.httpOnly,
+            secure: this.config.cookie.secure,
+            sameSite: this.config.cookie.sameSite,
+            path: this.config.cookie.path,
+            maxAge: this.config.lifetime,
+        });
+    }
+    getId() {
+        return this.sessionId;
+    }
+}
+/**
+ * Global Session Plugin factory.
+ * Attaches ctx.session to every request and auto-commits at response end.
+ *
+ * @example
+ * app.use(sessionPlugin({
+ *   driver: new RedisSessionDriver(redisClient),
+ *   lifetime: 8 * 3600, // 8-hour hospital shift
+ *   cookie: { httpOnly: true, secure: true, sameSite: 'Strict' }
+ * }));
+ */
+export function sessionPlugin(config = {}) {
+    const resolvedConfig = {
+        driver: config.driver ?? new MemorySessionDriver(),
+        cookieName: config.cookieName ?? 'aero_session',
+        lifetime: config.lifetime ?? 8 * 60 * 60, // 8 hours
+        cookie: {
+            httpOnly: true,
+            secure: process.env.NODE_ENV === 'production',
+            sameSite: 'lax',
+            path: '/',
+            ...config.cookie,
+        },
+    };
+    return async (ctx, next) => {
+        // Extract existing session ID from cookie, or create a new one
+        const existingId = ctx.cookies[resolvedConfig.cookieName];
+        const sessionId = existingId && existingId.length === 64
+            ? existingId
+            : crypto.randomBytes(32).toString('hex');
+        const session = new SessionManager(ctx, sessionId, resolvedConfig);
+        ctx.session = session;
+        try {
+            await next();
+        }
+        finally {
+            // Auto-commit session after response
+            await session.commit().catch(() => { });
+        }
+    };
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session/session-manager.js.map

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

package/dist/sse/index.d.ts

@@ -0,0 +1,2 @@
+export * from './sse.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sse/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/sse/index.js

@@ -0,0 +1,2 @@
+export * from './sse.js';
+//# sourceMappingURL=index.js.map

package/dist/sse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sse/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/sse/sse.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @file sse.ts
+ * @description Server-Sent Events (SSE) Streaming Engine for AeroJS.
+ */
+import type { ServerResponse } from 'node:http';
+export interface SseOptions {
+    heartbeatMs?: number;
+    retryMs?: number;
+}
+export declare class SseStream {
+    private res;
+    private heartbeatTimer?;
+    private isClosed;
+    constructor(res: ServerResponse, options?: SseOptions);
+    /**
+     * Send data to client with optional event name.
+     */
+    send(data: any, eventName?: string): this;
+    /**
+     * Send a named event to client.
+     */
+    sendEvent(type: string, data: any): this;
+    /**
+     * Starts a recurring heartbeat to keep the HTTP connection alive.
+     */
+    heartbeat(ms?: number): this;
+    /**
+     * Closes the SSE stream.
+     */
+    close(): void;
+}
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/sse/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAiB;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAS;gBAEb,GAAG,EAAE,cAAc,EAAE,OAAO,GAAE,UAAe;IA0BzD;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBhD;;OAEG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAI/C;;OAEG;IACI,SAAS,CAAC,EAAE,GAAE,MAAc,GAAG,IAAI;IAoB1C;;OAEG;IACI,KAAK,IAAI,IAAI;CAarB"}

package/dist/sse/sse.js

@@ -0,0 +1,87 @@
+/**
+ * @file sse.ts
+ * @description Server-Sent Events (SSE) Streaming Engine for AeroJS.
+ */
+export class SseStream {
+    res;
+    heartbeatTimer;
+    isClosed = false;
+    constructor(res, options = {}) {
+        this.res = res;
+        // Headers for SSE specification
+        if (!this.res.headersSent) {
+            this.res.setHeader('Content-Type', 'text/event-stream');
+            this.res.setHeader('Cache-Control', 'no-cache, no-transform');
+            this.res.setHeader('Connection', 'keep-alive');
+            this.res.setHeader('X-Accel-Buffering', 'no');
+            this.res.statusCode = 200;
+        }
+        if (options.retryMs) {
+            this.res.write(`retry: ${options.retryMs}\n\n`);
+        }
+        if (options.heartbeatMs) {
+            this.heartbeat(options.heartbeatMs);
+        }
+        this.res.on('close', () => {
+            this.close();
+        });
+    }
+    /**
+     * Send data to client with optional event name.
+     */
+    send(data, eventName) {
+        if (this.isClosed)
+            return this;
+        if (eventName) {
+            this.res.write(`event: ${eventName}\n`);
+        }
+        const payload = typeof data === 'string' ? data : JSON.stringify(data);
+        const lines = payload.split('\n');
+        for (const line of lines) {
+            this.res.write(`data: ${line}\n`);
+        }
+        this.res.write('\n\n');
+        return this;
+    }
+    /**
+     * Send a named event to client.
+     */
+    sendEvent(type, data) {
+        return this.send(data, type);
+    }
+    /**
+     * Starts a recurring heartbeat to keep the HTTP connection alive.
+     */
+    heartbeat(ms = 30000) {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+        }
+        this.heartbeatTimer = setInterval(() => {
+            if (this.isClosed) {
+                clearInterval(this.heartbeatTimer);
+                return;
+            }
+            this.res.write(': ping\n\n');
+        }, ms);
+        if (this.heartbeatTimer.unref) {
+            this.heartbeatTimer.unref();
+        }
+        return this;
+    }
+    /**
+     * Closes the SSE stream.
+     */
+    close() {
+        if (this.isClosed)
+            return;
+        this.isClosed = true;
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = undefined;
+        }
+        if (!this.res.writableEnded) {
+            this.res.end();
+        }
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse/sse.js.map

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

package/dist/ssr/engine.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file engine.ts
+ * @description Next.js / Inertia.js Server-Side Rendering (SSR) Engine for AeroJS.
+ * Supports React, Vue 3, and custom server-side component rendering with SEO meta tag extraction,
+ * hydration data injection, and graceful fallback to client shell.
+ */
+import type { InertiaPage } from '../inertia/inertia.js';
+export interface SSRRenderResult {
+    head?: string[];
+    body: string;
+}
+export type SSRRenderer = (page: InertiaPage) => Promise<SSRRenderResult | string> | SSRRenderResult | string;
+export interface SSREngineOptions {
+    /**
+     * Component registry or resolver mapping component names to executable functions/components.
+     */
+    components?: Record<string, any>;
+    resolveComponent?: (name: string) => any | Promise<any>;
+    /**
+     * Custom SSR render callback (e.g. using ReactDOMServer.renderToString or Vue renderToString).
+     */
+    render?: SSRRenderer;
+    /**
+     * Base HTML template containing @inertia and @head placeholders.
+     */
+    template?: string;
+    /**
+     * If true, errors in SSR will gracefully fall back to client shell instead of throwing.
+     * Default: true.
+     */
+    gracefulFallback?: boolean;
+}
+export declare class SSREngine {
+    private components;
+    private resolveComponent?;
+    private customRenderer?;
+    private template;
+    private gracefulFallback;
+    constructor(options?: SSREngineOptions);
+    /**
+     * Registers a component for server-side rendering.
+     */
+    register(name: string, component: any): this;
+    /**
+     * Resolves a component by name from registry or custom resolver.
+     */
+    getComponent(name: string): Promise<any | null>;
+    /**
+     * Performs server-side rendering of an Inertia page.
+     */
+    render(page: InertiaPage): Promise<{
+        html: string;
+        body: string;
+        head: string[];
+    }>;
+    private defaultTemplate;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/ssr/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/ssr/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,GAAG,eAAe,GAAG,MAAM,CAAC;AAE9G,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACxD;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,gBAAgB,CAAC,CAAuC;IAChE,OAAO,CAAC,cAAc,CAAC,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAU;gBAEtB,OAAO,GAAE,gBAAqB;IAY1C;;OAEG;IACI,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI;IAKnD;;OAEG;IACU,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAW5D;;OAEG;IACU,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA+D/F,OAAO,CAAC,eAAe;CAaxB"}

package/dist/ssr/engine.js

@@ -0,0 +1,121 @@
+/**
+ * @file engine.ts
+ * @description Next.js / Inertia.js Server-Side Rendering (SSR) Engine for AeroJS.
+ * Supports React, Vue 3, and custom server-side component rendering with SEO meta tag extraction,
+ * hydration data injection, and graceful fallback to client shell.
+ */
+export class SSREngine {
+    components = new Map();
+    resolveComponent;
+    customRenderer;
+    template;
+    gracefulFallback;
+    constructor(options = {}) {
+        if (options.components) {
+            for (const [name, comp] of Object.entries(options.components)) {
+                this.components.set(name, comp);
+            }
+        }
+        this.resolveComponent = options.resolveComponent;
+        this.customRenderer = options.render;
+        this.template = options.template || this.defaultTemplate();
+        this.gracefulFallback = options.gracefulFallback ?? true;
+    }
+    /**
+     * Registers a component for server-side rendering.
+     */
+    register(name, component) {
+        this.components.set(name, component);
+        return this;
+    }
+    /**
+     * Resolves a component by name from registry or custom resolver.
+     */
+    async getComponent(name) {
+        if (this.components.has(name)) {
+            return this.components.get(name);
+        }
+        if (this.resolveComponent) {
+            const comp = await this.resolveComponent(name);
+            if (comp)
+                return comp;
+        }
+        return null;
+    }
+    /**
+     * Performs server-side rendering of an Inertia page.
+     */
+    async render(page) {
+        let body = '';
+        const head = [];
+        try {
+            if (this.customRenderer) {
+                const res = await this.customRenderer(page);
+                if (typeof res === 'string') {
+                    body = res;
+                }
+                else {
+                    body = res.body;
+                    if (res.head)
+                        head.push(...res.head);
+                }
+            }
+            else {
+                // Built-in component resolver renderer
+                const component = await this.getComponent(page.component);
+                if (typeof component === 'function') {
+                    const rendered = await component(page.props);
+                    if (typeof rendered === 'string') {
+                        body = rendered;
+                    }
+                    else if (rendered && typeof rendered.body === 'string') {
+                        body = rendered.body;
+                        if (rendered.head)
+                            head.push(...rendered.head);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (!this.gracefulFallback) {
+                throw err;
+            }
+            // On SSR failure, body remains empty string and client shell will hydrate cleanly
+            body = '';
+        }
+        // Escape data-page for HTML attribute safety
+        const escaped = JSON.stringify(page)
+            .replace(/&/g, '&')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#039;');
+        const appHtml = `<div id="app" data-page="${escaped}">${body}</div>`;
+        const headHtml = head.join('\n  ');
+        let fullHtml = this.template;
+        // Inject head tags
+        if (fullHtml.includes('@head')) {
+            fullHtml = fullHtml.replace('@head', headHtml);
+        }
+        else if (headHtml && fullHtml.includes('</head>')) {
+            fullHtml = fullHtml.replace('</head>', `  ${headHtml}\n</head>`);
+        }
+        // Inject app container
+        fullHtml = fullHtml.replace(/@inertia|<!-- @inertia -->|<div id="app"><\/div>/, appHtml);
+        return { html: fullHtml, body, head };
+    }
+    defaultTemplate() {
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  @head
+</head>
+<body>
+  @inertia
+</body>
+</html>`;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/ssr/engine.js.map

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

package/dist/ssr/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file index.ts
+ * @description AeroJS Server-Side Rendering (SSR) Module.
+ */
+export * from './engine.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssr/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC"}

package/dist/ssr/index.js

@@ -0,0 +1,6 @@
+/**
+ * @file index.ts
+ * @description AeroJS Server-Side Rendering (SSR) Module.
+ */
+export * from './engine.js';
+//# sourceMappingURL=index.js.map

package/dist/ssr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ssr/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC"}

package/dist/static/static.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @file static.ts
+ * @description Zero-dependency high-performance static asset server with caching and SPA fallback.
+ */
+import type { Middleware } from '../core/types.js';
+import type { DefaultState } from '../core/context.js';
+export interface StaticOptions {
+    root: string;
+    prefix?: string;
+    index?: string;
+    spa?: boolean;
+    fallback?: string;
+    maxAge?: number;
+    etag?: boolean;
+    dotfiles?: 'ignore' | 'deny' | 'allow';
+}
+export declare function getMimeType(filePath: string): string;
+/**
+ * Creates a static asset serving middleware supporting ETags, Cache-Control, and SPA routing fallback.
+ */
+export declare function serveStatic<State = DefaultState>(options: StaticOptions): Middleware<State>;
+//# sourceMappingURL=static.d.ts.map

package/dist/static/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/static/static.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACxC;AA+BD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAG,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CA6G3F"}