tspace-spear 1.2.3 → 1.2.5-beta.1

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

@@ -1,17 +1,21 @@
 import http, { IncomingHttpHeaders, IncomingMessage, ServerResponse } from "http";
 import WebSocket from "ws";
-type TContext = {
+import net from 'net';
+type TContextBase = {
     req: TRequest;
     res: TResponse;
     headers: THeaders;
-    query: TQuery;
     params: TParams;
-    body: TBody;
-    files: TFileUpload;
     cookies: TCookies;
     ip: TIp;
+    ips: TIps;
+    body: TBody;
+    query: TQuery;
+    files: TFileUpload;
 };
+type TContext<Override extends Partial<Pick<TContextBase, "body" | "query" | "files" | "params">> = {}> = Omit<TContextBase, keyof Override> & Override;
 type TIp = string | null;
+type TIps = string[];
 type THeaders<T = IncomingHttpHeaders> = {
     [K in keyof T]: T[K];
 };
@@ -37,37 +41,121 @@ type TFile = {
 };
 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;
@@ -89,16 +177,16 @@ type TRoute = {
 };
 type TMethod = 'get' | 'post' | 'patch' | 'put' | 'delete' | 'all' | 'head' | 'options';
 type TMethodInput = Uppercase<TMethod>;
-type Handler = (res: unknown, req: unknown) => void | Promise<void>;
+type HandlerUWS = (res: unknown, req: unknown) => void | Promise<void>;
 type UWS = {
     App: () => {
-        get: (path: string, handler: Handler) => any;
-        post: (path: string, handler: Handler) => any;
-        patch: (path: string, handler: Handler) => any;
-        put: (path: string, handler: Handler) => any;
-        del: (path: string, handler: Handler) => any;
-        any: (path: string, handler: Handler) => any;
-        options: (path: string, handler: Handler) => any;
+        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;
@@ -107,22 +195,33 @@ type UWS = {
         }) => any;
     };
 };
-type TAdapter = UWS | typeof http;
+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?: TAdapter;
+    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";
@@ -164,40 +263,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[];
@@ -211,23 +310,24 @@ 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 Context<O extends Partial<Pick<TContextBase, "body" | "query" | "files" | "params">> = {}> = TContext<O>;
     type Adapter = TAdapter;
+    type AdapterServer = TAdapterServer;
     type Application = TApplication;
     type NextFunction = TNextFunction;
     type File = TFile;
-    type Context = TContext;
     type Router = TRouter;
     type Route = TRoute;
     type Method = TMethod;
     type ErrorFunction = TErrorFunction;
     type HttpStatus = THttpResponder;
-    type RequestFunction = TRequestFunction;
+    type ContextHandler = TContextHandler;
     type WebSocketHandler = TWSHandler;
     type StatusCode = TStatusCode;
     type MethodInput = TMethodInput;
@@ -239,6 +339,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;

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

@@ -0,0 +1,12 @@
+import { IncomingMessage, ServerResponse } from "http";
+import { Stream } from "stream";
+export declare const normalizeRequestBody: ({ contentType, payload, }: {
+    contentType: string | null;
+    payload: any;
+}) => Promise<any>;
+export declare const pipeStream: ({ req, res, filePath, isUwebSocket, }: {
+    req: IncomingMessage;
+    res: ServerResponse;
+    filePath: string;
+    isUwebSocket?: boolean;
+}) => Promise<Stream>;

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

@@ -0,0 +1,137 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pipeStream = exports.normalizeRequestBody = void 0;
+const const_1 = require("../const");
+const uWS_1 = require("../server/uWS");
+const querystring_1 = __importDefault(require("querystring"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const mime_types_1 = __importDefault(require("mime-types"));
+const xml2js_1 = __importDefault(require("xml2js"));
+const crypto_1 = __importDefault(require("crypto"));
+const normalizeRequestBody = async ({ contentType, payload, }) => {
+    if (contentType == null || payload == null || payload === "") {
+        return {};
+    }
+    if (contentType.includes("x-www-form-urlencoded")) {
+        return querystring_1.default.parse(payload);
+    }
+    if (contentType.includes("application/json")) {
+        try {
+            return JSON.parse(payload);
+        }
+        catch (err) {
+            throw new Error("Invalid JSON format in request body.");
+        }
+    }
+    if (contentType.includes("application/xml") ||
+        contentType.includes("text/xml")) {
+        try {
+            const result = await xml2js_1.default.parseStringPromise(payload, {
+                explicitArray: false,
+            });
+            return result;
+        }
+        catch (err) {
+            throw new Error("Invalid XML format in request body.");
+        }
+    }
+    if (contentType.includes("text/plain") ||
+        contentType.includes("text/javascript") ||
+        contentType.includes("application/javascript") ||
+        contentType.includes("application/x-javascript")) {
+        return { contentType, text: payload };
+    }
+    return {};
+};
+exports.normalizeRequestBody = normalizeRequestBody;
+const pipeStream = async ({ req, res, filePath, isUwebSocket, }) => {
+    if (!fs_1.default.existsSync(filePath)) {
+        return res
+            .writeHead(404, const_1.HEADER_CONTENT_TYPES["text"])
+            .end(`File not found: ${path_1.default.basename(filePath)}`);
+    }
+    if (isUwebSocket) {
+        return (0, uWS_1.uWSPipeStream)({ req, res, filePath });
+    }
+    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/");
+    const writeHead = (header, code = 200) => {
+        const extension = filePath.split(".").pop();
+        const previews = Object.values({
+            video: [
+                "mp4",
+                "webm",
+                "ogg",
+                "ogv",
+                "avi",
+                "mov",
+                "mkv",
+                "flv",
+                "f4v",
+                "wmv",
+                "ts",
+                "mpeg",
+            ],
+            audio: ["wav", "mp3"],
+            document: ["pdf"],
+            image: ["png", "jpeg", "jpg", "gif", "webp", "svg", "ico"],
+        }).flat();
+        if (previews.some((p) => extension?.toLocaleLowerCase().includes(p))) {
+            res.writeHead(code, header);
+            return;
+        }
+        res.setHeader("Content-Disposition", `attachment; filename=${+new Date()}.${extension}`);
+        res.setHeader("Content-Type", "application/octet-stream");
+    };
+    const maxAge = 1000 * 60 * 60 * 24 * 7;
+    const etag = crypto_1.default.createHash("md5").update(`${stat.size}-${stat.mtimeMs}`).digest("hex");
+    const baseHeader = {
+        "Connection": "keep-alive",
+        "Keep-Alive": "timeout=60, max=1000",
+        "Cache-Control": `public, max-age=${maxAge}, immutable`,
+        "Strict-transport-security": `max-age=${maxAge}; includeSubDomains`,
+        "ETag": `"${etag}"`,
+        "Date": new Date(stat.birthtimeMs).toUTCString(),
+        "Last-modified": new Date(stat.birthtimeMs).toUTCString(),
+        "Vary": "Origin, Accept-Encoding",
+        "Accept-Ranges": "bytes",
+        "Content-Length": fileSize,
+        "Content-Type": contentType,
+        "X-Content-type-options": "nosniff",
+        "X-Xss-protection": "1; mode=block",
+    };
+    if (!isVideo || range == null) {
+        const header = {
+            ...baseHeader,
+            "Content-Length": fileSize,
+            "Content-Type": contentType,
+        };
+        const stream = fs_1.default.createReadStream(filePath);
+        writeHead(header);
+        stream.on("error", () => res.end());
+        return stream.pipe(res);
+    }
+    const parts = range.replace(/bytes=/, "").split("-");
+    const start = parseInt(parts[0], 10);
+    const end = parts[1] ? parseInt(parts[1], 10) : fileSize - 1;
+    const chunksize = end - start + 1;
+    const stream = fs_1.default.createReadStream(filePath, { start, end });
+    const header = {
+        ...baseHeader,
+        "Content-Range": `bytes ${start}-${end}/${fileSize}`,
+        "Content-Length": chunksize,
+        "Accept-Ranges": "bytes"
+    };
+    writeHead(header, 206);
+    stream.on("error", () => res.end());
+    return stream.pipe(res);
+};
+exports.pipeStream = pipeStream;
+//# sourceMappingURL=index.js.map

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

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

package/dist/lib/index.d.ts

@@ -3,9 +3,10 @@
   *
   * @module tspace-spear
   */
+import Spear from './core/server';
 export * from './core/decorators';
-export * from './core/server/router';
+export * from './core/types';
 export * from './core/server';
-export { T } from './core/types';
-import Spear from './core/server';
+export * from './core/server/router';
+export * from './core/client';
 export default Spear;

package/dist/lib/index.js

@@ -22,9 +22,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
   *
   * @module tspace-spear
   */
+const server_1 = __importDefault(require("./core/server"));
 __exportStar(require("./core/decorators"), exports);
-__exportStar(require("./core/server/router"), exports);
+__exportStar(require("./core/types"), exports);
 __exportStar(require("./core/server"), exports);
-const server_1 = __importDefault(require("./core/server"));
+__exportStar(require("./core/server/router"), exports);
+__exportStar(require("./core/client"), exports);
 exports.default = server_1.default;
 //# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;;;;IAII;AACJ,oDAAiC;AACjC,uDAAoC;AACpC,gDAA6B;AAG7B,2DAAkC;AAElC,kBAAe,gBAAK,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;;;;IAII;AACJ,2DAAkC;AAElC,oDAAkC;AAClC,+CAA6B;AAC7B,gDAA8B;AAC9B,uDAAqC;AACrC,gDAA6B;AAE7B,kBAAe,gBAAK,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tspace-spear",
-  "version": "1.2.3",
+  "version": "1.2.5-beta.1",
   "description": "tspace-spear is a lightweight, high-performance API framework for Node.js that leverages the native HTTP server and supports uWebSockets.js (C++) for maximum speed and efficiency.",
   "main": "./dist/lib/index.js",
   "types": "./dist/lib/index.d.ts",
@@ -18,6 +18,8 @@
     "api",
     "rest api",
     "fast",
+    "fast-api",
+    "fast api",
     "low overhead",
     "http",
     "uWS",
@@ -35,9 +37,12 @@
     "prepare": "npm run build",
     "release": "npm run build && npm publish",
     "beta": "npm run build && npm publish --tag beta",
-    "benchmark": "npm run build && ts-node __tests__/benchmark.test.ts",
+    "bm:node": "npm run benchmark:node",
+    "bm:bun": "npm run benchmark:bun",
+    "benchmark:node": "npm run build && node benchmarks/tests/benchmark.node.js",
+    "benchmark:bun": "npm run build && bun run benchmarks/tests/benchmark.bun.js",
     "test": "mocha  dist/tests/**/0*.test.js",
-    "load": "autocannon -c 100 -d 30 -p 10 localhost:3000",
+    "load": "autocannon -c 100 -d 30 -p 10 localhost:5000",
     "docs": "npx docsify-cli serve docs"
   },
   "engines": {
@@ -45,36 +50,37 @@
   },
   "dependencies": {
     "busboy": "1.6.0",
-    "find-my-way": "8.2.2",
+    "fast-querystring": "1.1.2",
     "mime-types": "2.1.35",
     "on-finished": "2.4.1",
     "reflect-metadata": "0.2.2",
     "swagger-ui-dist": "5.32.0",
-    "ws": "8.19.0"
+    "ws": "8.19.0",
+    "xml2js": "0.6.2",
+    "ts-morph": "28.0.0"
   },
   "devDependencies": {
+    "@elysiajs/node": "1.4.5",
+    "@hono/node-server": "1.19.11",
     "@types/autocannon": "7.12.5",
     "@types/busboy": "1.5.4",
-    "@types/chai": "5.2.3",
-    "@types/chai-http": "4.2.4",
     "@types/express": "4.17.21",
-    "@types/jest": "30.0.0",
     "@types/mime-types": "2.1.4",
-    "@types/mocha": "10.0.10",
-    "@types/node": "16.4.0",
+    "@types/node": "16.18.126",
     "@types/on-finished": "2.3.4",
     "@types/swagger-ui-dist": "3.30.4",
     "@types/ws": "8.18.1",
-    "@types/yargs": "17.0.32",
+    "@types/xml2js": "0.4.14",
+    "0http": "4.4.0",
     "autocannon": "7.15.0",
-    "chai": "4.5.0",
-    "chai-http": "5.1.2",
     "docsify-cli": "4.4.4",
+    "elysia": "1.4.28",
     "express": "4.19.2",
     "fastify": "4.28.1",
+    "hono": "4.12.9",
     "ts-node": "10.9.2",
     "typescript": "5.9.3",
-    "yargs": "17.7.2",
+    "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.63.0",
     "zod": "4.3.6"
   }
 }