tspace-spear 1.2.3 → 1.2.5

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,9 @@
   *
   * @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 default Spear;

package/dist/lib/index.js

@@ -22,9 +22,10 @@ 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);
 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;AAErC,kBAAe,gBAAK,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tspace-spear",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "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,36 @@
   },
   "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"
   },
   "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"
   }
 }