tspace-spear 1.2.2 → 1.2.4

package/dist/lib/core/server/uWS/index.js

@@ -0,0 +1,357 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uWSPipeStream = exports.uWSfiles = exports.uWSBody = exports.uWSAdaptRequestResponse = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const mime_types_1 = __importDefault(require("mime-types"));
+const crypto_1 = __importDefault(require("crypto"));
+const const_1 = require("../../const");
+const utils_1 = require("../../utils");
+const uWSAdaptRequestResponse = (uwsReq, uwsRes) => {
+    const headers = {};
+    uwsReq.forEach((key, value) => {
+        headers[key.toLowerCase()] = value;
+    });
+    const req = {
+        uWS: uwsReq,
+        method: String(uwsReq.getMethod()).toUpperCase(),
+        url: uwsReq.getUrl() + (uwsReq.getQuery() ? `?${uwsReq.getQuery()}` : ""),
+        headers: headers,
+    };
+    const _writeHead = (status, context) => {
+        const statusMessage = const_1.HTTP_STATUS_MESSAGES[status] ||
+            const_1.HTTP_STATUS_MESSAGES[500];
+        res.uWS.writeStatus(`${status} ${statusMessage}`);
+        res.uWS.writeHeader(Object.keys(context)[0], Object.values(context)[0]);
+        return res;
+    };
+    const res = {
+        writeHeader: (key, value) => {
+            if (!res.aborted) {
+                uwsRes.writeHeader(key, value);
+            }
+            return res;
+        },
+        setHeader: (key, value) => {
+            if (!res.aborted) {
+                uwsRes.writeHeader(key, value);
+            }
+            return res;
+        },
+        writeHead(status, context) {
+            res.writeHeaders = {
+                ...res.writeHeaders,
+                [status]: context,
+            };
+            res.headersSent = true;
+            res.statusCode = status;
+            return res;
+        },
+        writeStatus: (status) => {
+            if (!res.aborted) {
+                res.uWS.writeStatus(status);
+            }
+            return res;
+        },
+        end: (str) => {
+            if (res.aborted) {
+                return;
+            }
+            if (str === undefined) {
+                return;
+            }
+            uwsRes.cork(() => {
+                if (!res.aborted) {
+                    res.aborted = true;
+                    res.writableEnded = true;
+                    for (const h in res.writeHeaders) {
+                        _writeHead(+h, res.writeHeaders[h]);
+                    }
+                    uwsRes.end(str);
+                    return;
+                }
+            });
+        },
+        writableEnded: false,
+        aborted: false,
+        writeHeaders: Object.create(null),
+        headersSent: false,
+        statusCode: 200,
+        uWS: uwsRes,
+    };
+    uwsRes.onAborted(() => {
+        res.aborted = true;
+    });
+    return { req, res };
+};
+exports.uWSAdaptRequestResponse = uWSAdaptRequestResponse;
+const uWSBody = (req, res) => {
+    return new Promise((resolve, reject) => {
+        let buffer = [];
+        res.uWS.onAborted(() => {
+            reject(new Error("Request aborted"));
+        });
+        res.uWS.onData(async (chunk, isLast) => {
+            buffer.push(Buffer.from(chunk));
+            if (!isLast)
+                return;
+            const payload = Buffer.concat(buffer).toString("utf-8");
+            const contentType = req.headers["content-type"]?.toLowerCase() ?? null;
+            try {
+                const body = await (0, utils_1.normalizeRequestBody)({ contentType, payload });
+                return resolve(body);
+            }
+            catch (err) {
+                return reject(err);
+            }
+        });
+    });
+};
+exports.uWSBody = uWSBody;
+const uWSfiles = async ({ req, res, options, }) => {
+    const temp = options.tempFileDir;
+    if (!fs_1.default.existsSync(temp)) {
+        try {
+            fs_1.default.mkdirSync(temp, { recursive: true });
+        }
+        catch { }
+    }
+    const removeTemp = (fileTemp, ms) => {
+        const remove = () => {
+            try {
+                fs_1.default.unlinkSync(fileTemp);
+            }
+            catch (err) { }
+        };
+        setTimeout(remove, ms);
+    };
+    const contentType = req.headers["content-type"] ?? "";
+    const boundary = contentType.split("boundary=")[1];
+    if (!boundary) {
+        throw new Error("Invalid multipart/form-data (no boundary)");
+    }
+    const boundaryBuf = Buffer.from(`\r\n--${boundary}`);
+    return new Promise((resolve, reject) => {
+        let body = {};
+        let files = {};
+        let buffer = Buffer.alloc(0);
+        let currentFileStream = null;
+        let file = null;
+        let headerParsed = false;
+        let aborted = false;
+        const fail = (err) => {
+            if (aborted)
+                return;
+            aborted = true;
+            try {
+                currentFileStream?.destroy();
+            }
+            catch { }
+            try {
+                file?.tempFilePath && fs_1.default.unlinkSync(file.tempFilePath);
+            }
+            catch { }
+            try {
+                res.uWS.close();
+            }
+            catch { }
+            return reject(err);
+        };
+        res.uWS.onData((chunk, isLast) => {
+            if (aborted)
+                return;
+            const data = Buffer.from(new Uint8Array(chunk));
+            buffer = buffer.length === 0 ? data : Buffer.concat([buffer, data]);
+            try {
+                while (true) {
+                    if (!headerParsed) {
+                        const headerEnd = buffer.indexOf("\r\n\r\n");
+                        if (headerEnd === -1)
+                            break;
+                        const header = buffer.slice(0, headerEnd).toString();
+                        buffer = buffer.slice(headerEnd + 4);
+                        const disposition = header.match(/name="([^"]+)"(?:; filename="([^"]+)")?/);
+                        if (!disposition)
+                            continue;
+                        const fieldName = disposition[1];
+                        const fileName = disposition[2];
+                        if (!fileName) {
+                            const nextBoundary = buffer.indexOf(boundaryBuf);
+                            if (nextBoundary === -1)
+                                break;
+                            const value = buffer.slice(0, nextBoundary).toString().trim();
+                            body[fieldName] = value;
+                            buffer = buffer.slice(nextBoundary + boundaryBuf.length);
+                            continue;
+                        }
+                        const contentTypeMatch = header.match(/Content-Type: ([^\r\n]+)/);
+                        const mimetype = contentTypeMatch
+                            ? contentTypeMatch[1]
+                            : "application/octet-stream";
+                        const extension = mime_types_1.default.extension(mimetype) ||
+                            path_1.default.extname(fileName).replace(".", "") ||
+                            "bin";
+                        const tempFilename = crypto_1.default.randomBytes(16).toString("hex");
+                        const filePath = path_1.default.join(path_1.default.resolve(), `${temp}/${tempFilename}`);
+                        currentFileStream = fs_1.default.createWriteStream(filePath);
+                        file = {
+                            name: fileName,
+                            tempFilePath: filePath,
+                            tempFileName: tempFilename,
+                            mimetype: mimetype,
+                            extension: extension,
+                            size: 0,
+                            sizes: {
+                                bytes: 0,
+                                kb: 0,
+                                mb: 0,
+                                gb: 0,
+                            },
+                            write: (to) => {
+                                return new Promise((resolve, reject) => {
+                                    fs_1.default
+                                        .createReadStream(filePath)
+                                        .pipe(fs_1.default.createWriteStream(to))
+                                        .on("finish", () => {
+                                        return resolve(null);
+                                    })
+                                        .on("error", (err) => {
+                                        return reject(err);
+                                    });
+                                });
+                            },
+                            remove: () => {
+                                return new Promise((resolve) => setTimeout(() => {
+                                    fs_1.default.unlinkSync(filePath);
+                                    return resolve(null);
+                                }, 100));
+                            },
+                        };
+                        if (!files[fieldName])
+                            files[fieldName] = [];
+                        files[fieldName].push(file);
+                        if (options.removeTempFile.remove) {
+                            removeTemp(filePath, options.removeTempFile.ms);
+                        }
+                        headerParsed = true;
+                    }
+                    const boundaryIndex = buffer.indexOf(boundaryBuf);
+                    if (boundaryIndex === -1) {
+                        const safeLength = buffer.length - boundaryBuf.length;
+                        if (safeLength > 0) {
+                            const writeChunk = buffer.slice(0, safeLength);
+                            currentFileStream.write(writeChunk);
+                            file.size += writeChunk.length;
+                            file.sizes = {
+                                bytes: file.size,
+                                kb: file.size / 1024,
+                                mb: file.size / 1024 / 1024,
+                                gb: file.size / 1024 / 1024 / 1024,
+                            };
+                            if (file.size > options.limit) {
+                                return fail(new Error(`File too large (limit ${options.limit} bytes)`));
+                            }
+                            buffer = buffer.slice(safeLength);
+                        }
+                        break;
+                    }
+                    const filePart = buffer.slice(0, boundaryIndex);
+                    currentFileStream.write(filePart);
+                    file.size += filePart.length;
+                    file.sizes = {
+                        bytes: file.size,
+                        kb: file.size / 1024,
+                        mb: file.size / 1024 / 1024,
+                        gb: file.size / 1024 / 1024 / 1024,
+                    };
+                    if (file.size > options.limit) {
+                        return fail(new Error(`File too large (limit ${options.limit} bytes)`));
+                    }
+                    currentFileStream.end();
+                    currentFileStream = null;
+                    file = null;
+                    buffer = buffer.slice(boundaryIndex + boundaryBuf.length);
+                    headerParsed = false;
+                }
+                if (isLast && !aborted) {
+                    if (currentFileStream)
+                        currentFileStream.end();
+                    return resolve({ body, files });
+                }
+            }
+            catch (err) {
+                return fail(err);
+            }
+        });
+    });
+};
+exports.uWSfiles = uWSfiles;
+const uWSPipeStream = async ({ req, res, filePath }) => {
+    //@ts-ignore
+    const uwsRes = res.uWS;
+    const stat = fs_1.default.statSync(filePath);
+    const fileSize = stat.size;
+    const range = req.headers["range"] ?? null;
+    const contentType = mime_types_1.default.lookup(filePath) || "application/octet-stream";
+    const isVideo = contentType.startsWith("video/");
+    //@ts-ignore
+    let aborted = res.aborted || false;
+    let stream;
+    let start = 0;
+    let end = fileSize - 1;
+    uwsRes.onAborted(() => {
+        aborted = true;
+        if (stream)
+            stream.destroy();
+    });
+    if (range && isVideo) {
+        const parts = range.replace(/bytes=/, "").split("-");
+        start = parseInt(parts[0], 10);
+        end = parts[1] ? parseInt(parts[1], 10) : end;
+        uwsRes.writeStatus("206 Partial Content");
+        uwsRes.writeHeader("Content-Range", `bytes ${start}-${end}/${fileSize}`);
+    }
+    else {
+        uwsRes.writeStatus("200 OK");
+    }
+    const chunkSize = end - start + 1;
+    uwsRes.writeHeader("Content-Type", contentType);
+    uwsRes.writeHeader("Accept-Ranges", "bytes");
+    uwsRes.writeHeader("Content-Length", chunkSize.toString());
+    stream = fs_1.default.createReadStream(filePath, { start, end });
+    stream.pause();
+    stream.on("data", (chunk) => {
+        if (aborted)
+            return;
+        const ok = uwsRes.cork(() => uwsRes.write(chunk));
+        if (!ok)
+            stream.pause();
+    });
+    uwsRes.onWritable(() => {
+        if (aborted)
+            return false;
+        stream.resume();
+        return true;
+    });
+    stream.on("end", () => {
+        if (!aborted) {
+            uwsRes.cork(() => {
+                uwsRes.end();
+            });
+        }
+    });
+    stream.on("error", () => {
+        if (!aborted) {
+            uwsRes.cork(() => {
+                uwsRes.writeStatus("500 Internal Server Error").end();
+            });
+        }
+    });
+    stream.resume();
+    return stream;
+};
+exports.uWSPipeStream = uWSPipeStream;
+//# sourceMappingURL=index.js.map

package/dist/lib/core/server/uWS/index.js.map

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

package/dist/lib/core/types/index.d.ts

@@ -1,8 +1,6 @@
-import { IncomingHttpHeaders, IncomingMessage, ServerResponse } from "http";
+import http, { IncomingHttpHeaders, IncomingMessage, ServerResponse } from "http";
 import WebSocket from "ws";
-type TDeepExpand<T> = T extends Date ? T : T extends Function ? T : T extends (infer U)[] ? TDeepExpand<U>[] : T extends object ? {
-    [K in keyof T]: TDeepExpand<T[K]>;
-} : T;
+import net from 'net';
 type TContext = {
     req: TRequest;
     res: TResponse;
@@ -12,7 +10,11 @@ type TContext = {
     body: TBody;
     files: TFileUpload;
     cookies: TCookies;
+    ip: TIp;
+    ips: TIps;
 };
+type TIp = string | null;
+type TIps = string[];
 type THeaders<T = IncomingHttpHeaders> = {
     [K in keyof T]: T[K];
 };
@@ -36,39 +38,123 @@ type TFile = {
     write: (to: string) => Promise<void>;
     remove: () => Promise<void>;
 };
-type TFileUpload = Record<string, TDeepExpand<TFile>[] | undefined>;
+type TFileUpload = Record<string, TFile[] | undefined>;
 type TNextFunction<T = any> = (err?: Error) => T | Promise<T>;
-type TRequest = IncomingMessage & Partial<any>;
+type TRequest = IncomingMessage & {
+    uWs: any;
+    query: TQuery;
+    files: TFileUpload;
+    body: TBody;
+    params: TParams;
+} & Partial<any>;
 type THttpResponder = {
-    /**200+ */
+    /**
+     * Raw uWS HttpResponse instance.
+     */
+    uWS: any;
+    /** 200 OK - Standard successful response */
     ok: (data?: Record<string, any>) => any;
+    /** 201 Created - Resource successfully created */
     created: (data?: Record<string, any>) => any;
+    /** 202 Accepted - Request accepted for processing */
     accepted: (data?: Record<string, any>) => any;
-    /**400+ */
+    /** 204 No Content - Successful request with no response body */
     noContent: (message?: string) => any;
+    /** 400 Bad Request - Invalid request from client */
     badRequest: (message?: string) => any;
+    /** 401 Unauthorized - Authentication required or failed */
     unauthorized: (message?: string) => any;
+    /** 402 Payment Required - Reserved for future/payment flow */
     paymentRequired: (message?: string) => any;
+    /** 403 Forbidden - Client does not have access rights */
     forbidden: (message?: string) => any;
+    /** 422 Unprocessable Entity - Valid request but semantic errors */
     unprocessable: (message?: string) => any;
+    /** 429 Too Many Requests - Rate limit exceeded */
     tooManyRequests: (message?: string) => any;
+    /** 404 Not Found - Resource does not exist */
     notFound: (message?: string) => any;
-    /**500+ */
+    /** 500 Internal Server Error - Generic server failure */
     serverError: (message?: string) => any;
+    /** 502 Bad Gateway - Invalid response from upstream server */
     badGateway: (message?: string) => any;
+    /** 503 Service Unavailable - Server temporarily unavailable */
     unavailable: (message?: string) => any;
+    /** 504 Gateway Timeout - Upstream server timeout */
     gatewayTimeout: (message?: string) => any;
-    /**helper */
+    /**
+     * Serve a media file (video, image, PDF, etc.) from file system.
+     * @param filePath Absolute or relative path to media file
+     */
+    serveMedia: (filePath: string) => any;
+    /**
+     * Send JSON response.
+     * @param data JSON serializable object
+     */
     json: (data?: Record<string, any>) => any;
+    /**
+     * Send error response (generic wrapper).
+     * @param err Error object or message
+     */
     error: (err: any) => any;
+    /**
+     * Send plain text response.
+     * @param message Text content
+     */
     send: (message: string) => any;
+    /**
+     * Send HTML response.
+     * @param html HTML string
+     */
     html: (html: string) => any;
+    /**
+     * Set HTTP status code and return chained response helpers.
+     *
+     * This method does not send a response immediately.
+     * Instead, it sets the status code and returns a response builder
+     * that allows sending the response in different formats.
+     *
+     * @param code HTTP status code to set for the response
+     * @returns An object containing response methods bound to the given status
+     *
+     * @example
+     * res.status(200).json({ success: true });
+     *
+     * @example
+     * res.status(404).send("Not Found");
+     *
+     * @example
+     * res.status(204).end();
+     */
     status: (code: TStatusCode) => {
+        /**
+         * Send JSON response with the previously set status code.
+         *
+         * @param data JSON-serializable object to send as response body
+         */
         json: (data?: Record<string, any>) => any;
+        /**
+         * Send plain text response with the previously set status code.
+         *
+         * @param message Text response body
+         */
         send: (message: string) => any;
+        /**
+         * End the response with optional raw message body.
+         *
+         * Commonly used for empty responses (e.g. 204 No Content).
+         *
+         * @param message Optional raw response body
+         */
+        end: (message?: string) => any;
     };
+    /**
+     * Set HTTP cookies.
+     * @param cookies Key-value map or detailed cookie objects
+     */
     setCookies: (cookies: Record<string, string | {
         value: string;
+        path?: string;
         sameSite?: 'Strict' | 'Lax' | 'None';
         domain?: string;
         secure?: boolean;
@@ -90,20 +176,51 @@ type TRoute = {
 };
 type TMethod = 'get' | 'post' | 'patch' | 'put' | 'delete' | 'all' | 'head' | 'options';
 type TMethodInput = Uppercase<TMethod>;
+type HandlerUWS = (res: unknown, req: unknown) => void | Promise<void>;
+type UWS = {
+    App: () => {
+        get: (path: string, handler: HandlerUWS) => any;
+        post: (path: string, handler: HandlerUWS) => any;
+        patch: (path: string, handler: HandlerUWS) => any;
+        put: (path: string, handler: HandlerUWS) => any;
+        del: (path: string, handler: HandlerUWS) => any;
+        any: (path: string, handler: HandlerUWS) => any;
+        options: (path: string, handler: HandlerUWS) => any;
+        listen: (...args: any[]) => any;
+        ws: (path: string, options: {
+            open?: (ws: any) => void;
+            message?: (ws: any, message: ArrayBuffer, isBinary: boolean) => void;
+            close?: (ws: any, code: number, message: ArrayBuffer) => void;
+        }) => any;
+    };
+};
+type TAdapter = {
+    kind: 'http';
+    server: typeof http;
+} | {
+    kind: 'net';
+    server: typeof net;
+} | {
+    kind: 'uWS';
+    server: UWS;
+};
+type TAdapterServer = typeof http | typeof net | UWS;
 type TApplication = {
     controllers?: (new () => any)[] | {
         folder: string;
         name?: RegExp;
     };
-    middlewares?: TRequestFunction[] | {
+    middlewares?: TContextHandler[] | {
         folder: string;
         name?: RegExp;
     };
     globalPrefix?: string;
     logger?: boolean;
     cluster?: boolean | number;
+    adapter?: TAdapterServer;
+    express?: boolean;
 };
-type TRequestFunction = (ctx: TContext, next: TNextFunction) => any;
+type TContextHandler = (ctx: TContext, next: TNextFunction) => any;
 type TErrorFunction = (err: Error, ctx: TContext) => any;
 type TSwaggerFormat = "string" | "number" | "integer" | "boolean" | "object" | "array" | "date" | "date-time" | "password" | "int32" | "int64" | "float" | "double" | "byte" | "binary" | "base64" | "email" | "uuid" | "uri" | "hostname" | "ipv4" | "ipv6" | "json" | "xml";
 type TSwaggerType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "date" | "date-time" | "file";
@@ -145,40 +262,40 @@ type TSwaggerDoc = {
         example?: Record<string, any>;
     }[];
 };
+type TSwaggerPropertyOptions = {
+    type: "array";
+    items: TSwaggerPropertyOptions;
+    enum?: never;
+    required?: boolean;
+    example?: any;
+    description?: string;
+    format?: TSwaggerFormat;
+} | {
+    type?: Exclude<TSwaggerType, "array">;
+    enum?: (string | number)[];
+    required?: boolean;
+    example?: any;
+    description?: string;
+    format?: TSwaggerFormat;
+    items?: never;
+};
 type TSwagger = {
     disabled?: boolean;
     description?: string;
     summary?: string;
     bearerToken?: boolean;
     tags?: string[];
-    params?: Record<string, {
-        description?: string;
-        type?: TSwaggerType;
-        example?: any;
-    }>;
-    query?: Record<string, {
-        required?: boolean;
-        description?: string;
-        type?: TSwaggerType;
-        example?: any;
-    }>;
+    params?: Record<string, TSwaggerPropertyOptions>;
+    query?: Record<string, TSwaggerPropertyOptions>;
     body?: {
         required?: boolean;
         description?: string;
-        properties: Record<string, {
-            type: TSwaggerType;
-            example?: any;
-        }>;
+        properties: Record<string, TSwaggerPropertyOptions>;
     };
     files?: {
         required?: boolean;
         description?: string;
-        properties: Record<string, {
-            type: TSwaggerType;
-            format?: TSwaggerFormat;
-            items?: any;
-            example?: any;
-        }>;
+        properties: Record<string, TSwaggerPropertyOptions>;
     };
     cookies?: {
         names: string[];
@@ -192,12 +309,14 @@ type TSwagger = {
     }[];
 };
 type TWSHandler = {
-    connection: (ws: WebSocket) => void | string | Buffer;
-    message: (ws: WebSocket, data: WebSocket.Data) => void | string | Buffer;
-    close: (ws: WebSocket, code: number, reason: Buffer) => void;
-    error: (ws: WebSocket, error: Error) => void;
+    connection: (ws: WebSocket & Partial<any>) => void | string | Buffer;
+    message: (ws: WebSocket & Partial<any>, data: WebSocket.Data) => void | string | Buffer;
+    close: (ws: WebSocket & Partial<any>, code: number, reason: Buffer) => void;
+    error: (ws: WebSocket & Partial<any>, error: Error) => void;
 };
 export declare namespace T {
+    type Adapter = TAdapter;
+    type AdapterServer = TAdapterServer;
     type Application = TApplication;
     type NextFunction = TNextFunction;
     type File = TFile;
@@ -207,7 +326,7 @@ export declare namespace T {
     type Method = TMethod;
     type ErrorFunction = TErrorFunction;
     type HttpStatus = THttpResponder;
-    type RequestFunction = TRequestFunction;
+    type ContextHandler = TContextHandler;
     type WebSocketHandler = TWSHandler;
     type StatusCode = TStatusCode;
     type MethodInput = TMethodInput;
@@ -219,6 +338,8 @@ export declare namespace T {
     type Query<T = Record<string, string>> = TQuery<T>;
     type Body<T = Record<string, any>> = TBody<T>;
     type Headers<T = IncomingHttpHeaders> = THeaders<T>;
+    type Ip = TIp;
+    type Ips = TIps;
     namespace Swagger {
         type Spec = TSwagger;
         type Format = TSwaggerFormat;