@heliosjs/core 1.0.2

package/dist/utils/core/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./controller"), exports);
+__exportStar(require("./cors"), exports);
+__exportStar(require("./endpoint"), exports);
+__exportStar(require("./error"), exports);
+__exportStar(require("./headers"), exports);
+__exportStar(require("./multipart"), exports);
+__exportStar(require("./request"), exports);
+__exportStar(require("./response"), exports);
+__exportStar(require("./routeWalker"), exports);
+__exportStar(require("./sanitize"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,yCAAuB;AACvB,6CAA2B;AAC3B,0CAAwB;AACxB,4CAA0B;AAC1B,8CAA4B;AAC5B,4CAA0B;AAC1B,6CAA2B;AAC3B,gDAA8B;AAC9B,6CAA2B"}

package/dist/utils/core/multipart.d.ts

@@ -0,0 +1,9 @@
+import { MultipartFile } from '../../types/core';
+export declare class MultipartProcessor {
+    static parse(request: any): {
+        fields: Record<string, any>;
+        files: Record<string, MultipartFile | MultipartFile[]>;
+    };
+    static isMultipart(request: any): boolean;
+    private static getContentType;
+}

package/dist/utils/core/multipart.js

@@ -0,0 +1,207 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultipartProcessor = void 0;
+// utils/MultipartProcessor.ts
+const multipart = __importStar(require("parse-multipart-data"));
+class MultipartProcessor {
+    static parse(request) {
+        const { body, headers, isBase64Encoded } = request;
+        if (!body) {
+            return { fields: {}, files: {} };
+        }
+        let contentType = headers['content-type'] ?? headers['Content-Type'] ?? '';
+        if (Array.isArray(contentType)) {
+            contentType = contentType[0];
+        }
+        if (!contentType.startsWith('multipart/form-data')) {
+            throw new Error('Not a multipart request');
+        }
+        const boundaryMatch = multipart.getBoundary(contentType);
+        if (!boundaryMatch) {
+            throw new Error('Invalid multipart boundary');
+        }
+        let bodyBuffer;
+        if (Buffer.isBuffer(body)) {
+            bodyBuffer = body;
+        }
+        else if (typeof body === 'string') {
+            bodyBuffer = isBase64Encoded ? Buffer.from(body, 'base64') : Buffer.from(body, 'binary');
+        }
+        else {
+            bodyBuffer = Buffer.from(JSON.stringify(body));
+        }
+        const parts = multipart.parse(bodyBuffer, boundaryMatch);
+        const fields = {};
+        const files = {};
+        parts.forEach((part) => {
+            if (part.filename) {
+                const fieldName = part.name || 'file';
+                const contentType = this.getContentType(part);
+                const fileData = {
+                    fieldname: fieldName,
+                    filename: part.filename,
+                    contentType: contentType ?? part.type,
+                    data: part.data,
+                    size: part.data.length,
+                    encoding: part.encoding,
+                };
+                if (files[fieldName]) {
+                    if (Array.isArray(files[fieldName])) {
+                        files[fieldName].push(fileData);
+                    }
+                    else {
+                        files[fieldName] = [files[fieldName], fileData];
+                    }
+                }
+                else {
+                    files[fieldName] = fileData;
+                }
+            }
+            else if (part.name) {
+                const text = part.data.toString('utf-8').trim();
+                try {
+                    fields[part.name] = JSON.parse(text);
+                }
+                catch {
+                    fields[part.name] = text;
+                }
+            }
+        });
+        return { fields, files };
+    }
+    static isMultipart(request) {
+        const contentType = request.headers?.['content-type'] || request.headers?.['Content-Type'] || '';
+        return contentType.startsWith('multipart/form-data');
+    }
+    static getContentType(part) {
+        const filename = part.filename || '';
+        const extension = filename.split('.').pop()?.toLowerCase() ?? '';
+        const mimeMap = {
+            txt: 'text/plain',
+            text: 'text/plain',
+            log: 'text/plain',
+            md: 'text/markdown',
+            csv: 'text/csv',
+            ts: 'application/typescript',
+            tsx: 'application/typescript',
+            js: 'application/javascript',
+            jsx: 'application/javascript',
+            mjs: 'application/javascript',
+            cjs: 'application/javascript',
+            json: 'application/json',
+            xml: 'application/xml',
+            yaml: 'application/yaml',
+            yml: 'application/yaml',
+            toml: 'application/toml',
+            php: 'application/x-httpd-php',
+            py: 'text/x-python',
+            rb: 'text/x-ruby',
+            java: 'text/x-java',
+            c: 'text/x-c',
+            cpp: 'text/x-c++',
+            h: 'text/x-c',
+            hpp: 'text/x-c++',
+            go: 'text/x-go',
+            rs: 'text/x-rust',
+            swift: 'text/x-swift',
+            kt: 'text/x-kotlin',
+            kts: 'text/x-kotlin',
+            html: 'text/html',
+            htm: 'text/html',
+            css: 'text/css',
+            scss: 'text/x-scss',
+            sass: 'text/x-sass',
+            less: 'text/x-less',
+            jpg: 'image/jpeg',
+            jpeg: 'image/jpeg',
+            png: 'image/png',
+            gif: 'image/gif',
+            webp: 'image/webp',
+            svg: 'image/svg+xml',
+            ico: 'image/x-icon',
+            bmp: 'image/bmp',
+            tiff: 'image/tiff',
+            tif: 'image/tiff',
+            avif: 'image/avif',
+            heic: 'image/heic',
+            heif: 'image/heif',
+            pdf: 'application/pdf',
+            doc: 'application/msword',
+            docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+            xls: 'application/vnd.ms-excel',
+            xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+            ppt: 'application/vnd.ms-powerpoint',
+            pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+            odt: 'application/vnd.oasis.opendocument.text',
+            ods: 'application/vnd.oasis.opendocument.spreadsheet',
+            odp: 'application/vnd.oasis.opendocument.presentation',
+            zip: 'application/zip',
+            rar: 'application/vnd.rar',
+            '7z': 'application/x-7z-compressed',
+            tar: 'application/x-tar',
+            gz: 'application/gzip',
+            bz2: 'application/x-bzip2',
+            mp3: 'audio/mpeg',
+            wav: 'audio/wav',
+            ogg: 'audio/ogg',
+            m4a: 'audio/mp4',
+            flac: 'audio/flac',
+            aac: 'audio/aac',
+            mp4: 'video/mp4',
+            mpg: 'video/mpeg',
+            mpeg: 'video/mpeg',
+            mov: 'video/quicktime',
+            avi: 'video/x-msvideo',
+            wmv: 'video/x-ms-wmv',
+            flv: 'video/x-flv',
+            webm: 'video/webm',
+            mkv: 'video/x-matroska',
+            m4v: 'video/x-m4v',
+            bin: 'application/octet-stream',
+            exe: 'application/vnd.microsoft.portable-executable',
+            dll: 'application/vnd.microsoft.portable-executable',
+            deb: 'application/vnd.debian.binary-package',
+            rpm: 'application/x-rpm',
+            iso: 'application/x-iso9660-image',
+            sh: 'application/x-sh',
+            bat: 'application/x-msdos-program',
+            ps1: 'application/x-powershell',
+        };
+        return mimeMap[extension];
+    }
+}
+exports.MultipartProcessor = MultipartProcessor;
+//# sourceMappingURL=multipart.js.map

package/dist/utils/core/multipart.js.map

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

package/dist/utils/core/request.d.ts

@@ -0,0 +1,100 @@
+import { IncomingHttpHeaders } from 'http';
+import { URL } from 'url';
+import { IRequest, RequestOptions, RequestSource } from '../../types/core/request';
+export declare class Request implements IRequest {
+    method: string;
+    path: string;
+    requestUrl: URL;
+    url: string;
+    headers: Record<string, string | string[]>;
+    query: Record<string, string | string[]>;
+    body: any;
+    rawBody: any;
+    params: Record<string, string>;
+    cookies: Record<string, string>;
+    sourceIp: string;
+    userAgent: string;
+    requestId: string;
+    stage: string;
+    timestamp: Date;
+    source: RequestSource;
+    raw: any;
+    context: any;
+    isBase64Encoded: boolean;
+    startTime: number;
+    private _state;
+    constructor(options: RequestOptions);
+    base64Encoded(): boolean;
+    /**
+     * Get header value (case-insensitive)
+     */
+    getHeader(name: string): string | string[] | undefined;
+    /**
+     * Get cookie value
+     */
+    getCookie(name: string): string | undefined;
+    /**
+     * Get query parameter
+     */
+    getQuery(name: string): string | string[] | undefined;
+    /**
+     * Get path parameter
+     */
+    getParam(name: string): string | undefined;
+    /**
+     * Check if request is from HTTP server
+     */
+    isHttp(): boolean;
+    /**
+     * Check if request is from Lambda
+     */
+    isLambda(): boolean;
+    /**
+     * Get Lambda event (if from Lambda)
+     */
+    getLambdaEvent(): any;
+    /**
+     * Get Lambda context (if from Lambda)
+     */
+    getLambdaContext(): any;
+    /**
+     * Get HTTP IncomingMessage (if from HTTP)
+     */
+    getHttpRequest(): IncomingHttpHeaders | undefined;
+    /**
+     * Store arbitrary data in request state
+     */
+    setState(key: string, value: any): void;
+    /**
+     * Get stored state data
+     */
+    getState<T = any>(key: string): T | undefined;
+    /**
+     * Get all stored state
+     */
+    getAllState(): Map<string, any>;
+    /**
+     * Check if request is secure (HTTPS)
+     */
+    isSecure(): boolean;
+    /**
+     * Get client IP (considering proxies)
+     */
+    getClientIp(): string;
+    /**
+     * Get request host
+     */
+    getHost(): string;
+    /**
+     * Get full URL
+     */
+    getFullUrl(): string;
+    /**
+     * Clone request with modifications
+     */
+    clone(overrides?: Partial<RequestOptions>): Request;
+    /**
+     * Convert to plain object
+     */
+    toJSON(): Record<string, any>;
+}

package/dist/utils/core/request.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Request = void 0;
+const url_1 = require("url");
+class Request {
+    method;
+    path;
+    requestUrl;
+    url;
+    headers;
+    query;
+    body;
+    rawBody;
+    params;
+    cookies;
+    sourceIp;
+    userAgent;
+    requestId;
+    stage;
+    timestamp;
+    source;
+    raw;
+    context;
+    isBase64Encoded;
+    startTime;
+    _state = new Map();
+    constructor(options) {
+        this.method = options.method.toUpperCase();
+        this.path = options.path;
+        this.url = options.path;
+        this.requestUrl = new url_1.URL(options.path, `http://${options.headers?.host || 'localhost'}`);
+        this.headers = options.headers || {};
+        this.query = options.query || {};
+        this.body = options.body;
+        this.params = options.params || {};
+        this.cookies = options.cookies || {};
+        this.sourceIp = options.sourceIp || '0.0.0.0';
+        this.userAgent = options.userAgent || 'unknown';
+        this.requestId = options.requestId;
+        this.stage = options.stage || 'dev';
+        this.timestamp = options.timestamp || new Date();
+        this.source = options.source;
+        this.raw = options.raw ?? options.event;
+        this.context = options.context;
+        this.url = options.url;
+        this.rawBody = options.rawBody;
+        this.raw = options.raw;
+        this.isBase64Encoded = options.isBase64Encoded ?? this.base64Encoded();
+        this.startTime = Date.now();
+    }
+    base64Encoded() {
+        if (this.isLambda() && this.raw?.isBase64Encoded) {
+            return this.raw.isBase64Encoded;
+        }
+        const encoding = this.getHeader('content-encoding');
+        if (encoding === 'base64') {
+            return true;
+        }
+        const transferEncoding = this.getHeader('transfer-encoding');
+        if (transferEncoding === 'base64') {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get header value (case-insensitive)
+     */
+    getHeader(name) {
+        const lowerName = name.toLowerCase();
+        const entry = Object.entries(this.headers).find(([key]) => key.toLowerCase() === lowerName);
+        return entry ? entry[1] : undefined;
+    }
+    /**
+     * Get cookie value
+     */
+    getCookie(name) {
+        return this.cookies[name];
+    }
+    /**
+     * Get query parameter
+     */
+    getQuery(name) {
+        return this.query[name];
+    }
+    /**
+     * Get path parameter
+     */
+    getParam(name) {
+        return this.params[name];
+    }
+    /**
+     * Check if request is from HTTP server
+     */
+    isHttp() {
+        return this.source === 'http';
+    }
+    /**
+     * Check if request is from Lambda
+     */
+    isLambda() {
+        return this.source === 'lambda';
+    }
+    /**
+     * Get Lambda event (if from Lambda)
+     */
+    getLambdaEvent() {
+        return this.isLambda() ? this.raw : undefined;
+    }
+    /**
+     * Get Lambda context (if from Lambda)
+     */
+    getLambdaContext() {
+        return this.isLambda() ? this.context : undefined;
+    }
+    /**
+     * Get HTTP IncomingMessage (if from HTTP)
+     */
+    getHttpRequest() {
+        return this.isHttp() ? this.raw : undefined;
+    }
+    /**
+     * Store arbitrary data in request state
+     */
+    setState(key, value) {
+        this._state.set(key, value);
+    }
+    /**
+     * Get stored state data
+     */
+    getState(key) {
+        return this._state.get(key);
+    }
+    /**
+     * Get all stored state
+     */
+    getAllState() {
+        return new Map(this._state);
+    }
+    /**
+     * Check if request is secure (HTTPS)
+     */
+    isSecure() {
+        const proto = this.getHeader('x-forwarded-proto') || this.requestUrl.protocol.replace(':', '');
+        return proto === 'https';
+    }
+    /**
+     * Get client IP (considering proxies)
+     */
+    getClientIp() {
+        const forwarded = this.getHeader('x-forwarded-for');
+        if (forwarded) {
+            const ips = Array.isArray(forwarded) ? forwarded : forwarded.split(',');
+            return ips[0].trim();
+        }
+        return this.sourceIp;
+    }
+    /**
+     * Get request host
+     */
+    getHost() {
+        return this.getHeader('host') || 'localhost';
+    }
+    /**
+     * Get full URL
+     */
+    getFullUrl() {
+        const protocol = this.isSecure() ? 'https' : 'http';
+        return `${protocol}://${this.getHost()}${this.path}`;
+    }
+    /**
+     * Clone request with modifications
+     */
+    clone(overrides) {
+        return new Request({
+            method: overrides?.method || this.method,
+            path: overrides?.path || this.path,
+            headers: overrides?.headers || this.headers,
+            query: overrides?.query || this.query,
+            body: overrides?.body !== undefined ? overrides.body : this.body,
+            params: overrides?.params || this.params,
+            cookies: overrides?.cookies || this.cookies,
+            sourceIp: overrides?.sourceIp || this.sourceIp,
+            userAgent: overrides?.userAgent || this.userAgent,
+            requestId: overrides?.requestId || this.requestId,
+            stage: overrides?.stage || this.stage,
+            timestamp: overrides?.timestamp || this.timestamp,
+            source: this.source,
+            raw: this.raw,
+            context: this.context,
+            url: this.url,
+            isBase64Encoded: false,
+            requestUrl: this.requestUrl,
+        });
+    }
+    /**
+     * Convert to plain object
+     */
+    toJSON() {
+        return {
+            method: this.method,
+            path: this.path,
+            url: this.url.toString(),
+            headers: this.headers,
+            query: this.query,
+            body: this.body,
+            params: this.params,
+            cookies: this.cookies,
+            sourceIp: this.sourceIp,
+            userAgent: this.userAgent,
+            requestId: this.requestId,
+            stage: this.stage,
+            timestamp: this.timestamp.toISOString(),
+            source: this.source,
+        };
+    }
+}
+exports.Request = Request;
+//# sourceMappingURL=request.js.map

package/dist/utils/core/request.js.map

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

package/dist/utils/core/response.d.ts

@@ -0,0 +1,48 @@
+import { CookieOptions, IResponse } from '../../types/core';
+import { Meta } from '../../types/core/common';
+import { ResponseSource } from '../../types/core/response';
+export declare class Response implements IResponse {
+    private _status;
+    private _headers;
+    private _data;
+    private _cookies;
+    private _isBase64Encoded;
+    private _headersSent;
+    private _source;
+    private _raw;
+    meta: Meta;
+    constructor(source: ResponseSource | undefined, meta: Meta, raw?: any);
+    requestId: string;
+    get headers(): Record<string, string | string[]>;
+    get ok(): boolean;
+    get data(): any;
+    set data(data: any);
+    get raw(): any;
+    get cookies(): string[];
+    get isBase64Encoded(): boolean;
+    get source(): ResponseSource;
+    get headersSent(): boolean;
+    set status(code: number);
+    get status(): number;
+    getStatus(): number;
+    setHeader(name: string, value: string | string[]): this;
+    getHeader(name: string): string | string[] | undefined;
+    hasHeader(name: string): boolean;
+    removeHeader(name: string): this;
+    setHeaders(headers: Record<string, string | string[]>): this;
+    setCookie(name: string, value: string, options?: CookieOptions): this;
+    clearCookie(name: string, options?: CookieOptions): this;
+    getCookies(): string[];
+    send(body: any): this;
+    json(data: any): this;
+    text(text: string): this;
+    html(html: string): this;
+    buffer(data: Buffer, contentType?: string): this;
+    stream(readable: NodeJS.ReadableStream, contentType?: string): this;
+    end(data: unknown): any;
+    redirect(url: string, statusCode?: number): this;
+    notFound(message?: string): this;
+    reset(): this;
+    toJSON(): Record<string, any>;
+    error(error: any): this;
+}