@shohaghinfo/aerojs 0.1.0

package/dist/core/response.js

@@ -0,0 +1,302 @@
+/**
+ * @file response.ts
+ * @description AeroResponse wrapper around Node.js ServerResponse.
+ */
+import { Readable, pipeline } from 'node:stream';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { serializeCookie } from './utils.js';
+/**
+ * AeroResponse wraps standard Node.js `ServerResponse` with chainable status,
+ * headers, cookies, redirects, and automated content-type serializers.
+ */
+export class AeroResponse {
+    raw;
+    _isSent = false;
+    _bodyPayload = undefined;
+    _cookieHeaders = [];
+    isHead = false;
+    serializer;
+    customProperties = new Map();
+    constructor(raw) {
+        this.raw = raw;
+    }
+    get headersSent() {
+        return this.raw.headersSent;
+    }
+    get isSent() {
+        return this._isSent || this.raw.writableEnded;
+    }
+    get statusCode() {
+        return this.raw.statusCode;
+    }
+    status(code) {
+        this.raw.statusCode = code;
+        return this;
+    }
+    set(nameOrHeaders, value) {
+        if (this.raw.headersSent) {
+            return this;
+        }
+        if (typeof nameOrHeaders === 'string') {
+            if (value !== undefined) {
+                this.raw.setHeader(nameOrHeaders, value);
+            }
+        }
+        else if (typeof nameOrHeaders === 'object' && nameOrHeaders !== null) {
+            for (const [key, val] of Object.entries(nameOrHeaders)) {
+                if (val !== undefined) {
+                    this.raw.setHeader(key, val);
+                }
+            }
+        }
+        return this;
+    }
+    setHeader(name, value) {
+        return this.set(name, value);
+    }
+    getHeader(name) {
+        return this.get(name);
+    }
+    get(name) {
+        return this.raw.getHeader(name);
+    }
+    removeHeader(name) {
+        if (!this.raw.headersSent) {
+            this.raw.removeHeader(name);
+        }
+        return this;
+    }
+    type(contentType) {
+        let type = contentType;
+        if (type === 'json')
+            type = 'application/json; charset=utf-8';
+        else if (type === 'html')
+            type = 'text/html; charset=utf-8';
+        else if (type === 'text')
+            type = 'text/plain; charset=utf-8';
+        return this.set('Content-Type', type);
+    }
+    cookie(name, value, options = {}) {
+        const cookieStr = serializeCookie(name, value, options);
+        this._cookieHeaders.push(cookieStr);
+        this.raw.setHeader('Set-Cookie', this._cookieHeaders);
+        return this;
+    }
+    setCookie(name, value, options = {}) {
+        return this.cookie(name, value, options);
+    }
+    clearCookie(name, options = {}) {
+        return this.cookie(name, '', {
+            ...options,
+            expires: new Date(0),
+            maxAge: 0,
+        });
+    }
+    redirect(url, status = 302) {
+        this.status(status);
+        this.set('Location', url);
+        this.type('text/plain; charset=utf-8');
+        this.send(`Redirecting to ${url}`);
+    }
+    json(data) {
+        if (!this.raw.getHeader('Content-Type')) {
+            this.type('application/json; charset=utf-8');
+        }
+        const payload = this.serializer ? this.serializer(data) : JSON.stringify(data);
+        this.send(payload);
+    }
+    text(data) {
+        if (!this.raw.getHeader('Content-Type')) {
+            this.type('text/plain; charset=utf-8');
+        }
+        this.send(String(data));
+    }
+    html(data) {
+        if (!this.raw.getHeader('Content-Type')) {
+            this.type('text/html; charset=utf-8');
+        }
+        this.send(data);
+    }
+    send(data) {
+        if (this._isSent || this.raw.writableEnded) {
+            return;
+        }
+        this._bodyPayload = data;
+        if (data === null || data === undefined) {
+            if (!this.raw.statusCode || this.raw.statusCode === 200) {
+                this.status(204);
+            }
+            this.raw.removeHeader('Content-Type');
+            this.raw.removeHeader('Content-Length');
+            this.flushEnd();
+            return;
+        }
+        if (data instanceof Readable) {
+            this._isSent = true;
+            if (!this.raw.getHeader('Content-Type')) {
+                this.type('application/octet-stream');
+            }
+            if (this.isHead) {
+                this.raw.end();
+            }
+            else {
+                pipeline(data, this.raw, (err) => {
+                    if (err && !this.raw.writableEnded) {
+                        this.raw.destroy(err);
+                    }
+                });
+            }
+            return;
+        }
+        if (Buffer.isBuffer(data) || data instanceof Uint8Array) {
+            if (!this.raw.getHeader('Content-Type')) {
+                this.type('application/octet-stream');
+            }
+            const buffer = Buffer.isBuffer(data) ? data : Buffer.from(data);
+            this.set('Content-Length', buffer.length);
+            this.flushEnd(buffer);
+            return;
+        }
+        if (typeof data === 'string') {
+            if (!this.raw.getHeader('Content-Type')) {
+                const trimmed = data.trim();
+                if (trimmed.startsWith('<') && trimmed.endsWith('>')) {
+                    this.type('text/html; charset=utf-8');
+                }
+                else {
+                    this.type('text/plain; charset=utf-8');
+                }
+            }
+            const buffer = Buffer.from(data, 'utf-8');
+            this.set('Content-Length', buffer.length);
+            this.flushEnd(buffer);
+            return;
+        }
+        if (typeof data === 'number' || typeof data === 'boolean' || typeof data === 'bigint') {
+            const str = String(data);
+            if (!this.raw.getHeader('Content-Type')) {
+                this.type('text/plain; charset=utf-8');
+            }
+            const buffer = Buffer.from(str, 'utf-8');
+            this.set('Content-Length', buffer.length);
+            this.flushEnd(buffer);
+            return;
+        }
+        if (typeof data === 'object') {
+            if (!this.raw.getHeader('Content-Type')) {
+                this.type('application/json; charset=utf-8');
+            }
+            const serialized = this.serializer ? this.serializer(data) : JSON.stringify(data);
+            const buffer = Buffer.from(serialized, 'utf-8');
+            this.set('Content-Length', buffer.length);
+            this.flushEnd(buffer);
+            return;
+        }
+        const str = String(data);
+        const buffer = Buffer.from(str, 'utf-8');
+        this.set('Content-Length', buffer.length);
+        this.flushEnd(buffer);
+    }
+    flushEnd(chunk) {
+        this._isSent = true;
+        if (this.isHead) {
+            this.raw.end();
+        }
+        else if (chunk !== undefined) {
+            this.raw.end(chunk);
+        }
+        else {
+            this.raw.end();
+        }
+    }
+    async streamFile(req, filePath, options = {}) {
+        if (this._isSent || this.raw.writableEnded)
+            return;
+        try {
+            const stat = await fs.promises.stat(filePath);
+            const totalSize = stat.size;
+            const fileName = options.filename || path.basename(filePath);
+            if (options.download) {
+                this.set('Content-Disposition', `attachment; filename="${fileName}"`);
+            }
+            else {
+                this.set('Content-Disposition', 'inline');
+            }
+            if (!this.raw.getHeader('Content-Type')) {
+                this.type('application/octet-stream'); // Default, let mime-types or caller override
+            }
+            if (options.range !== false) {
+                this.set('Accept-Ranges', 'bytes');
+            }
+            const rangeHeader = req.headers.range;
+            if (options.range !== false && rangeHeader) {
+                // Range: bytes=0-1024
+                const parts = rangeHeader.replace(/bytes=/, '').split('-');
+                const start = parseInt(parts[0], 10);
+                const end = parts[1] ? parseInt(parts[1], 10) : totalSize - 1;
+                if (start >= totalSize || end >= totalSize || start > end) {
+                    this.status(416); // Range Not Satisfiable
+                    this.set('Content-Range', `bytes */${totalSize}`);
+                    this.flushEnd();
+                    return;
+                }
+                const chunksize = end - start + 1;
+                const readStream = fs.createReadStream(filePath, { start, end });
+                this.status(206); // Partial Content
+                this.set('Content-Range', `bytes ${start}-${end}/${totalSize}`);
+                this.set('Content-Length', chunksize);
+                this._isSent = true;
+                if (this.isHead) {
+                    this.raw.end();
+                    readStream.destroy();
+                }
+                else {
+                    pipeline(readStream, this.raw, (err) => {
+                        if (err && !this.raw.writableEnded) {
+                            this.raw.destroy(err);
+                        }
+                    });
+                }
+            }
+            else {
+                // Normal full file stream
+                this.set('Content-Length', totalSize);
+                const readStream = fs.createReadStream(filePath);
+                this._isSent = true;
+                if (this.isHead) {
+                    this.raw.end();
+                    readStream.destroy();
+                }
+                else {
+                    pipeline(readStream, this.raw, (err) => {
+                        if (err && !this.raw.writableEnded) {
+                            this.raw.destroy(err);
+                        }
+                    });
+                }
+            }
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                this.status(404).send('File Not Found');
+            }
+            else {
+                this.status(500).send('Internal Server Error while reading file');
+            }
+        }
+    }
+    get payload() {
+        return this._bodyPayload;
+    }
+    set payload(val) {
+        this._bodyPayload = val;
+    }
+    getCustom(key) {
+        return this.customProperties.get(key);
+    }
+    setCustom(key, value) {
+        this.customProperties.set(key, value);
+    }
+}
+//# sourceMappingURL=response.js.map

package/dist/core/response.js.map

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

package/dist/core/router.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file router.ts
+ * @description Radix Tree routing engine supporting route params, wildcards, regex caching,
+ * route naming, 405 Method Not Allowed discovery, route groups, and controller resolution.
+ */
+import type { DefaultState } from './context.js';
+import type { Middleware, RouteParams } from './types.js';
+import { NamedMiddlewareRegistry } from '../routing/named-middleware.js';
+import { RouteBuilder } from '../routing/route-builder.js';
+import { RouteGroup } from '../routing/route-group.js';
+export interface RouteSchema {
+    body?: unknown;
+    query?: unknown;
+    querystring?: unknown;
+    params?: unknown;
+    headers?: unknown;
+    response?: Record<string | number, unknown>;
+}
+export interface Route<State = DefaultState> {
+    readonly method: string;
+    readonly path: string;
+    handlers: (Middleware<State> | string)[];
+    schema?: RouteSchema;
+    name?: string;
+}
+export interface RouteMatch<State = DefaultState> {
+    readonly route: Route<State>;
+    readonly params: RouteParams;
+    readonly handlers: readonly (Middleware<State> | string)[];
+}
+export declare function normalizeRouteHandlers<State = DefaultState>(rawHandlers: any[]): (Middleware<State> | string)[];
+export declare class Router<State = DefaultState> {
+    readonly namedMiddleware?: NamedMiddlewareRegistry<State> | undefined;
+    private readonly root;
+    private readonly allRoutes;
+    private readonly namedRoutes;
+    private readonly regexCache;
+    get routes(): readonly Route<State>[];
+    constructor(namedMiddleware?: NamedMiddlewareRegistry<State> | undefined);
+    registerNamedRoute(name: string, route: Route<State>): void;
+    add(method: string, path: string, handlers: any[], schema?: RouteSchema, name?: string): RouteBuilder<State>;
+    match(method: string, path: string): RouteMatch<State> | null;
+    hasPath(path: string): boolean;
+    allowedMethods(path: string): string[];
+    private searchNode;
+    mount(prefix: string, subRouter: Router<State>): this;
+    group(prefix: string, callback: (group: RouteGroup<State>) => void): this;
+    urlFor(name: string, params?: Record<string, string | number>): string;
+    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>;
+    head(path: string, ...handlers: any[]): RouteBuilder<State>;
+    options(path: string, ...handlers: any[]): RouteBuilder<State>;
+    all(path: string, ...handlers: any[]): RouteBuilder<State>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/core/router.d.ts.map

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

package/dist/core/router.js

@@ -0,0 +1,298 @@
+/**
+ * @file router.ts
+ * @description Radix Tree routing engine supporting route params, wildcards, regex caching,
+ * route naming, 405 Method Not Allowed discovery, route groups, and controller resolution.
+ */
+import { normalizePath } from './utils.js';
+import { NamedMiddlewareRegistry } from '../routing/named-middleware.js';
+import { RouteBuilder } from '../routing/route-builder.js';
+import { RouteGroup } from '../routing/route-group.js';
+import { isControllerTuple, createControllerHandler, } from '../routing/controller.js';
+class RadixNode {
+    children = new Map();
+    paramChild;
+    wildcardChild;
+    routes = new Map();
+}
+function splitPath(path) {
+    const norm = normalizePath(path);
+    if (norm === '/') {
+        return [];
+    }
+    return norm.slice(1).split('/');
+}
+export function normalizeRouteHandlers(rawHandlers) {
+    const result = [];
+    for (let i = 0; i < rawHandlers.length; i++) {
+        const h = rawHandlers[i];
+        if (Array.isArray(h)) {
+            if (isControllerTuple(h)) {
+                result.push(createControllerHandler(h[0], h[1]));
+            }
+            else {
+                result.push(...normalizeRouteHandlers(h));
+            }
+            continue;
+        }
+        if (typeof h === 'function' &&
+            h.prototype &&
+            i + 1 < rawHandlers.length &&
+            typeof rawHandlers[i + 1] === 'string' &&
+            typeof h.prototype[rawHandlers[i + 1]] === 'function') {
+            result.push(createControllerHandler(h, rawHandlers[i + 1]));
+            i++; // Skip the method name
+            continue;
+        }
+        if (typeof h === 'function' || typeof h === 'string') {
+            result.push(h);
+            continue;
+        }
+        throw new TypeError(`Invalid route handler: ${typeof h}`);
+    }
+    return result;
+}
+export class Router {
+    namedMiddleware;
+    root = new RadixNode();
+    allRoutes = [];
+    namedRoutes = new Map();
+    regexCache = new Map();
+    get routes() {
+        return this.allRoutes;
+    }
+    constructor(namedMiddleware) {
+        this.namedMiddleware = namedMiddleware;
+    }
+    registerNamedRoute(name, route) {
+        this.namedRoutes.set(name, route);
+    }
+    add(method, path, handlers, schema, name) {
+        const upperMethod = method.toUpperCase();
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        let current = this.root;
+        for (let i = 0; i < segments.length; i++) {
+            const segment = segments[i];
+            if (segment.startsWith('*')) {
+                const paramName = segment.length > 1 ? segment.slice(1) : '*';
+                if (!current.wildcardChild) {
+                    current.wildcardChild = {
+                        paramName,
+                        node: new RadixNode(),
+                    };
+                }
+                current = current.wildcardChild.node;
+                break;
+            }
+            else if (segment.startsWith(':')) {
+                const paramName = segment.slice(1);
+                if (!current.paramChild) {
+                    current.paramChild = {
+                        paramName,
+                        node: new RadixNode(),
+                    };
+                }
+                current = current.paramChild.node;
+            }
+            else {
+                let child = current.children.get(segment);
+                if (!child) {
+                    child = new RadixNode();
+                    current.children.set(segment, child);
+                }
+                current = child;
+            }
+        }
+        const normalizedHandlers = normalizeRouteHandlers(handlers);
+        const route = {
+            method: upperMethod,
+            path: normalized,
+            handlers: normalizedHandlers,
+            schema,
+            name,
+        };
+        current.routes.set(upperMethod, route);
+        this.allRoutes.push(route);
+        if (name) {
+            this.namedRoutes.set(name, route);
+        }
+        // Cache precompiled regex for fast pattern testing
+        if (!this.regexCache.has(normalized)) {
+            const pattern = normalized
+                .replace(/:([a-zA-Z0-9_]+)/g, '(?<$1>[^/]+)')
+                .replace(/\*([a-zA-Z0-9_]+)/g, '(?<$1>.*)')
+                .replace(/\*/g, '(.*)');
+            this.regexCache.set(normalized, new RegExp(`^${pattern}$`));
+        }
+        return new RouteBuilder(route, this, this.namedMiddleware);
+    }
+    match(method, path) {
+        const upperMethod = method.toUpperCase();
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        const params = {};
+        const node = this.searchNode(this.root, segments, 0, params);
+        if (!node) {
+            return null;
+        }
+        let route = node.routes.get(upperMethod);
+        if (!route) {
+            route = node.routes.get('ALL');
+        }
+        if (!route && upperMethod === 'HEAD') {
+            route = node.routes.get('GET');
+        }
+        if (!route) {
+            return null;
+        }
+        return {
+            route,
+            params,
+            handlers: route.handlers,
+        };
+    }
+    hasPath(path) {
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        const params = {};
+        const node = this.searchNode(this.root, segments, 0, params);
+        return Boolean(node && node.routes.size > 0);
+    }
+    allowedMethods(path) {
+        const normalized = normalizePath(path);
+        const segments = splitPath(normalized);
+        const params = {};
+        const node = this.searchNode(this.root, segments, 0, params);
+        if (!node) {
+            return [];
+        }
+        const methods = new Set();
+        for (const m of node.routes.keys()) {
+            if (m === 'ALL') {
+                methods.add('GET');
+                methods.add('POST');
+                methods.add('PUT');
+                methods.add('PATCH');
+                methods.add('DELETE');
+                methods.add('HEAD');
+                methods.add('OPTIONS');
+            }
+            else {
+                methods.add(m);
+            }
+        }
+        if (methods.has('GET')) {
+            methods.add('HEAD');
+        }
+        methods.add('OPTIONS');
+        return Array.from(methods);
+    }
+    searchNode(current, segments, index, params) {
+        if (index === segments.length) {
+            if (current.routes.size > 0) {
+                return current;
+            }
+            if (current.wildcardChild && current.wildcardChild.node.routes.size > 0) {
+                params[current.wildcardChild.paramName] = '';
+                return current.wildcardChild.node;
+            }
+            return null;
+        }
+        const segment = segments[index];
+        const child = current.children.get(segment);
+        if (child) {
+            const match = this.searchNode(child, segments, index + 1, params);
+            if (match)
+                return match;
+        }
+        if (current.paramChild) {
+            params[current.paramChild.paramName] = segment;
+            const match = this.searchNode(current.paramChild.node, segments, index + 1, params);
+            if (match)
+                return match;
+            delete params[current.paramChild.paramName];
+        }
+        if (current.wildcardChild) {
+            const remaining = segments.slice(index).join('/');
+            params[current.wildcardChild.paramName] = remaining;
+            return current.wildcardChild.node;
+        }
+        return null;
+    }
+    mount(prefix, subRouter) {
+        const cleanPrefix = normalizePath(prefix);
+        for (const route of subRouter.allRoutes) {
+            const combinedPath = route.path === '/'
+                ? cleanPrefix
+                : normalizePath(`${cleanPrefix}${route.path}`);
+            this.add(route.method, combinedPath, [...route.handlers], route.schema, route.name);
+        }
+        return this;
+    }
+    group(prefix, callback) {
+        const group = new RouteGroup(prefix, this, this.namedMiddleware);
+        callback(group);
+        return this;
+    }
+    urlFor(name, params = {}) {
+        const route = this.namedRoutes.get(name);
+        if (!route) {
+            throw new Error(`Route with name '${name}' not found`);
+        }
+        let url = route.path;
+        const remainingParams = { ...params };
+        // Replace :param placeholders
+        const paramMatches = Array.from(url.matchAll(/:([a-zA-Z0-9_]+)/g));
+        for (const match of paramMatches) {
+            const paramName = match[1];
+            if (!(paramName in remainingParams)) {
+                throw new Error(`Missing required route parameter '${paramName}' for route '${name}'.`);
+            }
+            url = url.replace(`:${paramName}`, encodeURIComponent(String(remainingParams[paramName])));
+            delete remainingParams[paramName];
+        }
+        // Replace *wildcard or * placeholders
+        const wildcardMatches = Array.from(url.matchAll(/\*([a-zA-Z0-9_]*)/g));
+        for (const match of wildcardMatches) {
+            const wildcardName = match[1] || '*';
+            if (wildcardName in remainingParams) {
+                url = url.replace(`*${match[1]}`, String(remainingParams[wildcardName]));
+                delete remainingParams[wildcardName];
+            }
+        }
+        // Append any unused parameters as a query string
+        const queryEntries = Object.entries(remainingParams);
+        if (queryEntries.length > 0) {
+            const qs = queryEntries
+                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+                .join('&');
+            url = `${url}?${qs}`;
+        }
+        return url;
+    }
+    get(path, ...handlers) {
+        return this.add('GET', path, handlers);
+    }
+    post(path, ...handlers) {
+        return this.add('POST', path, handlers);
+    }
+    put(path, ...handlers) {
+        return this.add('PUT', path, handlers);
+    }
+    patch(path, ...handlers) {
+        return this.add('PATCH', path, handlers);
+    }
+    delete(path, ...handlers) {
+        return this.add('DELETE', path, handlers);
+    }
+    head(path, ...handlers) {
+        return this.add('HEAD', path, handlers);
+    }
+    options(path, ...handlers) {
+        return this.add('OPTIONS', path, handlers);
+    }
+    all(path, ...handlers) {
+        return this.add('ALL', path, handlers);
+    }
+}
+//# sourceMappingURL=router.js.map