cpeak 2.4.3 → 2.5.0

package/README.md

@@ -131,7 +131,7 @@ const requireAuth = (req, res, next, handleErr) => {
   return handleErr({ status: 401, message: "Unauthorized" });
 };
 
-server.route("get", "/profile", requireAuth, (req, res, handleErr) => {
+server.route("get", "/profile", requireAuth, (req, res) => {
   console.log(req.test); // this is a test value
 });
 ```
@@ -145,7 +145,7 @@ server.route(
   requireAuth,
   anotherFunction,
   oneMore,
-  (req, res, handleErr) => {
+  (req, res) => {
     // your logic
   }
 );
@@ -165,16 +165,15 @@ First add the HTTP method name you want to handle, then the path, and finally, t
 
 ### URL Variables & Parameters
 
-Since in HTTP these are called URL parameters: `/path?key1=value1&key2=value2&foo=900`, in Cpeak, we also call them `params` (short for HTTP URL parameters).
-We can also do custom path management, and we call them `vars` (short for URL variables).
+To be more consistent with the broader Node.js community and frameworks, we call the HTTP URL parameters (query strings) '**query**', and the path variables (route parameters) '**params**'.
 
 Here’s how we can read both:
 
 ```javascript
 // Imagine request URL is example.com/test/my-title/more-text?filter=newest
 server.route("patch", "/test/:title/more-text", (req, res) => {
-  const title = req.vars.title;
-  const filter = req.params.filter;
+  const title = req.params.title;
+  const filter = req.query.filter;
 
   console.log(title); // my-title
   console.log(filter); // newest
@@ -206,11 +205,23 @@ res.redirect("https://whatever.com");
 
 ### Error Handling
 
-If anywhere in your route functions or route middleware functions you want to return an error, it's cleaner to pass it to the `handleErr` function like this:
+If anywhere in your route functions or route middleware functions you want to return an error, you can just throw the error and let the automatic error handler catch it:
+
+```javascript
+server.route("get", "/api/document/:title", (req, res) => {
+  const title = req.params.title;
+
+  if (title.length > 500) throw { status: 400, message: "Title too long." };
+
+  // The rest of your logic...
+});
+```
+
+You can also make use of the `handleErr` callback function like this:
 
 ```javascript
 server.route("get", "/api/document/:title", (req, res, handleErr) => {
-  const title = req.vars.title;
+  const title = req.params.title;
 
   if (title.length > 500)
     return handleErr({ status: 400, message: "Title too long." });
@@ -219,7 +230,7 @@ server.route("get", "/api/document/:title", (req, res, handleErr) => {
 });
 ```
 
-And then handle all the errors like this in the `handleErr` callback:
+**Make sure** to call the `server.handleErr` and pass a function like this to have the automatic error handler work properly:
 
 ```javascript
 server.handleErr((error, req, res) => {
@@ -229,13 +240,13 @@ server.handleErr((error, req, res) => {
     // Log the unexpected errors somewhere so you can keep track of them...
     console.error(error);
     res.status(500).json({
-      error: "Sorry, something unexpected happened on our side.",
+      error: "Sorry, something unexpected happened on our side."
     });
   }
 });
 ```
 
-The error object is the object that you passed to the `handleErr` function earlier in your routes.
+_The error object is the object that you threw or passed to the `handleErr` function earlier in your routes._
 
 ### Listening
 
@@ -270,7 +281,7 @@ With this middleware function, you can automatically set a folder in your projec
 ```javascript
 server.beforeEach(
   serveStatic("./public", {
-    mp3: "audio/mpeg",
+    mp3: "audio/mpeg"
   })
 );
 ```
@@ -298,7 +309,9 @@ If you have file types in your public folder that are not one of the following,
 With this middleware function, you can easily read and send JSON in HTTP message bodies in route and middleware functions. Fire it up like this:
 
 ```javascript
-server.beforeEach(parseJSON);
+// You can pass an optional limit option to indicate the maximum
+// JSON body size that your server will accept.
+server.beforeEach(parseJSON({ limit: 1024 * 1024 })); // default value is 1024 * 1024 (1MB)
 ```
 
 Read and send JSON from HTTP messages like this:
@@ -333,7 +346,7 @@ server.route("get", "/", (req, res, next) => {
     "./public/index.html",
     {
       title: "Page title",
-      name: "Allan",
+      name: "Allan"
     },
     "text/html"
   );
@@ -364,14 +377,14 @@ const server = cpeak();
 
 server.beforeEach(
   serveStatic("./public", {
-    mp3: "audio/mpeg",
+    mp3: "audio/mpeg"
   })
 );
 
 server.beforeEach(render());
 
 // For parsing JSON bodies
-server.beforeEach(parseJSON);
+server.beforeEach(parseJSON());
 
 // Adding custom middleware functions
 server.beforeEach((req, res, next) => {
@@ -383,7 +396,7 @@ server.beforeEach((req, res, next) => {
 const testRouteMiddleware = (req, res, next, handleErr) => {
   req.whatever = "some calculated value maybe";
 
-  if (req.vars.test !== "something special") {
+  if (req.params.test !== "something special") {
     return handleErr({ status: 400, message: "an error message" });
   }
 
@@ -396,7 +409,7 @@ server.route("get", "/", (req, res, next) => {
     "<path-to-file-relative-to-cwd>",
     {
       test: "some testing value",
-      number: "2343242",
+      number: "2343242"
     },
     "<mime-type>"
   );
@@ -406,28 +419,23 @@ server.route("get", "/old-url", testRouteMiddleware, (req, res, next) => {
   return res.redirect("/new-url");
 });
 
-server.route(
-  "get",
-  "/api/document/:title",
-  testRouteMiddleware,
-  (req, res, handleErr) => {
-    // Reading URL variables
-    const title = req.vars.title;
+server.route("get", "/api/document/:title", testRouteMiddleware, (req, res) => {
+  // Reading URL variables (route parameters)
+  const title = req.params.title;
 
-    // Reading URL parameters (like /users?filter=active)
-    const filter = req.params.filter;
+  // Reading URL parameters (query strings) (like /users?filter=active)
+  const filter = req.query.filter;
 
-    // Reading JSON request body
-    const anything = req.body.anything;
+  // Reading JSON request body
+  const anything = req.body.anything;
 
-    // Handling errors
-    if (anything === "not-expected-thing")
-      return handleErr({ status: 400, message: "Invalid property." });
+  // Handling errors
+  if (anything === "not-expected-thing")
+    throw { status: 400, message: "Invalid property." };
 
-    // Sending a JSON response
-    res.status(200).json({ message: "This is a test response" });
-  }
-);
+  // Sending a JSON response
+  res.status(200).json({ message: "This is a test response" });
+});
 
 // Sending a file response
 server.route("get", "/file", (req, res) => {
@@ -442,7 +450,7 @@ server.handleErr((error, req, res) => {
   } else {
     console.error(error);
     res.status(500).json({
-      error: "Sorry, something unexpected happened from our side.",
+      error: "Sorry, something unexpected happened from our side."
     });
   }
 });

package/dist/index.d.ts

@@ -2,12 +2,11 @@ import http, { IncomingMessage, ServerResponse } from 'node:http';
 
 type Cpeak$1 = ReturnType<typeof cpeak>;
 type StringMap = Record<string, string>;
-interface CpeakRequest<ReqBody = any, ReqParams = any> extends IncomingMessage {
-    params: ReqParams;
-    vars?: StringMap;
+interface CpeakRequest<ReqBody = any, ReqQueries = any> extends IncomingMessage {
+    params: StringMap;
+    query: ReqQueries;
     body?: ReqBody;
     [key: string]: any;
-    query: ReqParams;
 }
 interface CpeakResponse extends ServerResponse {
     sendFile: (path: string, mime: string) => Promise<void>;
@@ -33,18 +32,35 @@ interface RoutesMap {
 
 declare const serveStatic: (folderPath: string, newMimeTypes?: StringMap) => (req: CpeakRequest, res: CpeakResponse, next: Next) => void | Promise<void>;
 
-declare const parseJSON: (req: CpeakRequest, res: CpeakResponse, next: Next) => void;
+declare const parseJSON: (options?: {
+    limit?: number;
+}) => (req: CpeakRequest, res: CpeakResponse, next: Next) => void;
 
 declare const render: () => (req: CpeakRequest, res: CpeakResponse, next: Next) => void;
 
-declare function frameworkError(message: string, skipFn: Function, code?: string): Error & {
+declare function frameworkError(message: string, skipFn: Function, code?: string, status?: number): Error & {
     code?: string;
+    cpeak_err?: boolean;
 };
 declare enum ErrorCode {
     MISSING_MIME = "CPEAK_ERR_MISSING_MIME",
     FILE_NOT_FOUND = "CPEAK_ERR_FILE_NOT_FOUND",
     NOT_A_FILE = "CPEAK_ERR_NOT_A_FILE",
-    SEND_FILE_FAIL = "CPEAK_ERR_SEND_FILE_FAIL"
+    SEND_FILE_FAIL = "CPEAK_ERR_SEND_FILE_FAIL",
+    INVALID_JSON = "CPEAK_ERR_INVALID_JSON",
+    PAYLOAD_TOO_LARGE = "CPEAK_ERR_PAYLOAD_TOO_LARGE"
+}
+declare class CpeakIncomingMessage extends http.IncomingMessage {
+    body: any;
+    params: StringMap;
+    private _query?;
+    get query(): StringMap;
+}
+declare class CpeakServerResponse extends http.ServerResponse<CpeakIncomingMessage> {
+    sendFile(path: string, mime: string): Promise<void>;
+    status(code: number): this;
+    redirect(location: string): this;
+    json(data: any): void;
 }
 declare class Cpeak {
     #private;
@@ -56,7 +72,7 @@ declare class Cpeak {
     route(method: string, path: string, ...args: (RouteMiddleware | Handler)[]): void;
     beforeEach(cb: Middleware): void;
     handleErr(cb: (err: unknown, req: CpeakRequest, res: CpeakResponse) => void): void;
-    listen(port: number, cb?: () => void): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
+    listen(port: number, cb?: () => void): http.Server<typeof CpeakIncomingMessage, typeof CpeakServerResponse>;
     close(cb?: (err?: Error) => void): void;
 }
 

package/dist/index.js

@@ -65,22 +65,58 @@ var serveStatic = (folderPath, newMimeTypes) => {
   };
 };
 
-// lib/utils/parseJSON.ts
-var parseJSON = (req, res, next) => {
-  function isJSON(contentType = "") {
-    const [type] = contentType.split(";");
-    return type.trim().toLowerCase() === "application/json" || /\+json$/i.test(type.trim());
-  }
-  if (!isJSON(req.headers["content-type"])) return next();
-  let body = "";
-  req.on("data", (chunk) => {
-    body += chunk.toString("utf-8");
-  });
-  req.on("end", () => {
-    body = JSON.parse(body);
-    req.body = body;
-    return next();
-  });
+// lib/utils/paseJSON.ts
+import { Buffer } from "buffer";
+function isJSON(contentType) {
+  if (!contentType) return false;
+  if (contentType === "application/json") return true;
+  return contentType.startsWith("application/json") || contentType.includes("+json");
+}
+var parseJSON = (options = {}) => {
+  const limit = options.limit || 1024 * 1024;
+  return (req, res, next) => {
+    if (!isJSON(req.headers["content-type"])) return next();
+    const chunks = [];
+    let bytesReceived = 0;
+    const onData = (chunk) => {
+      bytesReceived += chunk.length;
+      if (bytesReceived > limit) {
+        req.pause();
+        req.removeListener("data", onData);
+        req.removeListener("end", onEnd);
+        next(
+          frameworkError(
+            "JSON body too large",
+            onData,
+            "CPEAK_ERR_PAYLOAD_TOO_LARGE" /* PAYLOAD_TOO_LARGE */,
+            413
+            // HTTP 413 Payload Too Large
+          )
+        );
+        return;
+      }
+      chunks.push(chunk);
+    };
+    const onEnd = () => {
+      try {
+        const rawBody = chunks.length === 1 ? chunks[0].toString("utf-8") : Buffer.concat(chunks).toString("utf-8");
+        req.body = rawBody ? JSON.parse(rawBody) : {};
+        next();
+      } catch (err) {
+        next(
+          frameworkError(
+            "Invalid JSON format",
+            onEnd,
+            "CPEAK_ERR_INVALID_JSON" /* INVALID_JSON */,
+            400
+            // HTTP 400 Bad Request
+          )
+        );
+      }
+    };
+    req.on("data", onData);
+    req.on("end", onEnd);
+  };
 };
 
 // lib/utils/render.ts
@@ -108,7 +144,6 @@ function renderTemplate(templateStr, data) {
   return result.join("");
 }
 var render = () => {
-  console.log("render.ts loaded");
   return function(req, res, next) {
     res.render = async (path2, data, mime) => {
       if (!mime) {
@@ -127,10 +162,12 @@ var render = () => {
 };
 
 // lib/index.ts
-function frameworkError(message, skipFn, code) {
+function frameworkError(message, skipFn, code, status) {
   const err = new Error(message);
   Error.captureStackTrace(err, skipFn);
+  err.cpeak_err = true;
   if (code) err.code = code;
+  if (status) err.status = status;
   return err;
 }
 var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
@@ -138,101 +175,123 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2["FILE_NOT_FOUND"] = "CPEAK_ERR_FILE_NOT_FOUND";
   ErrorCode2["NOT_A_FILE"] = "CPEAK_ERR_NOT_A_FILE";
   ErrorCode2["SEND_FILE_FAIL"] = "CPEAK_ERR_SEND_FILE_FAIL";
+  ErrorCode2["INVALID_JSON"] = "CPEAK_ERR_INVALID_JSON";
+  ErrorCode2["PAYLOAD_TOO_LARGE"] = "CPEAK_ERR_PAYLOAD_TOO_LARGE";
   return ErrorCode2;
 })(ErrorCode || {});
+var CpeakIncomingMessage = class extends http.IncomingMessage {
+  // We define body and params here for better V8 optimization (not changing the shape of the object at runtime)
+  body = void 0;
+  params = {};
+  _query;
+  // Parse the URL parameters (like /users?key1=value1&key2=value2)
+  // We will call this query to be more familiar with other node.js frameworks.
+  // This is a getter method (accessed like a property)
+  get query() {
+    if (this._query) return this._query;
+    const url = this.url || "";
+    const qIndex = url.indexOf("?");
+    if (qIndex === -1) {
+      this._query = {};
+    } else {
+      const searchParams = new URLSearchParams(url.substring(qIndex + 1));
+      this._query = Object.fromEntries(searchParams.entries());
+    }
+    return this._query;
+  }
+};
+var CpeakServerResponse = class extends http.ServerResponse {
+  // Send a file back to the client
+  async sendFile(path2, mime) {
+    if (!mime) {
+      throw frameworkError(
+        'MIME type is missing. Use res.sendFile(path, "mime-type").',
+        this.sendFile,
+        "CPEAK_ERR_MISSING_MIME" /* MISSING_MIME */
+      );
+    }
+    try {
+      const stat = await fs3.stat(path2);
+      if (!stat.isFile()) {
+        throw frameworkError(
+          `Not a file: ${path2}`,
+          this.sendFile,
+          "CPEAK_ERR_NOT_A_FILE" /* NOT_A_FILE */
+        );
+      }
+      this.setHeader("Content-Type", mime);
+      this.setHeader("Content-Length", String(stat.size));
+      await pipeline(createReadStream(path2), this);
+    } catch (err) {
+      if (err?.code === "ENOENT") {
+        throw frameworkError(
+          `File not found: ${path2}`,
+          this.sendFile,
+          "CPEAK_ERR_FILE_NOT_FOUND" /* FILE_NOT_FOUND */
+        );
+      }
+      throw frameworkError(
+        `Failed to send file: ${path2}`,
+        this.sendFile,
+        "CPEAK_ERR_SEND_FILE_FAIL" /* SEND_FILE_FAIL */
+      );
+    }
+  }
+  // Set the status code of the response
+  status(code) {
+    this.statusCode = code;
+    return this;
+  }
+  // Redirects to a new URL
+  redirect(location) {
+    this.writeHead(302, { Location: location });
+    this.end();
+    return this;
+  }
+  // Send a json data back to the client (for small json data, less than the highWaterMark)
+  json(data) {
+    this.setHeader("Content-Type", "application/json");
+    this.end(JSON.stringify(data));
+  }
+};
 var Cpeak = class {
   server;
   routes;
   middleware;
   _handleErr;
   constructor() {
-    this.server = http.createServer();
+    this.server = http.createServer({
+      IncomingMessage: CpeakIncomingMessage,
+      ServerResponse: CpeakServerResponse
+    });
     this.routes = {};
     this.middleware = [];
-    this.server.on("request", (req, res) => {
-      res.sendFile = async (path2, mime) => {
-        if (!mime) {
-          throw frameworkError(
-            'MIME type is missing. Use res.sendFile(path, "mime-type").',
-            res.sendFile,
-            "CPEAK_ERR_MISSING_MIME" /* MISSING_MIME */
-          );
-        }
-        try {
-          const stat = await fs3.stat(path2);
-          if (!stat.isFile()) {
-            throw frameworkError(
-              `Not a file: ${path2}`,
-              res.sendFile,
-              "CPEAK_ERR_NOT_A_FILE" /* NOT_A_FILE */
-            );
-          }
-          res.setHeader("Content-Type", mime);
-          res.setHeader("Content-Length", String(stat.size));
-          await pipeline(createReadStream(path2), res);
-        } catch (err) {
-          if (err?.code === "ENOENT") {
-            throw frameworkError(
-              `File not found: ${path2}`,
-              res.sendFile,
-              "CPEAK_ERR_FILE_NOT_FOUND" /* FILE_NOT_FOUND */
-            );
-          }
-          throw frameworkError(
-            `Failed to send file: ${path2}`,
-            res.sendFile,
-            "CPEAK_ERR_SEND_FILE_FAIL" /* SEND_FILE_FAIL */
-          );
-        }
-      };
-      res.status = (code) => {
-        res.statusCode = code;
-        return res;
-      };
-      res.redirect = (location) => {
-        res.writeHead(302, { Location: location });
-        res.end();
-        return res;
-      };
-      res.json = (data) => {
-        res.setHeader("Content-Type", "application/json");
-        res.end(JSON.stringify(data));
-      };
-      const urlWithoutParams = req.url?.split("?")[0];
-      const params = new URLSearchParams(req.url?.split("?")[1]);
-      const paramsObject = Object.fromEntries(params.entries());
-      req.params = paramsObject;
-      req.query = paramsObject;
-      const runHandler = (req2, res2, middleware, cb, index) => {
+    this.server.on("request", async (req, res) => {
+      const qIndex = req.url?.indexOf("?");
+      const urlWithoutQueries = qIndex === -1 ? req.url || "" : req.url?.substring(0, qIndex);
+      const runHandler = async (req2, res2, middleware, cb, index) => {
         if (index === middleware.length) {
           try {
-            const handlerResult = cb(req2, res2, (error) => {
+            await cb(req2, res2, (error) => {
               res2.setHeader("Connection", "close");
               this._handleErr?.(error, req2, res2);
             });
-            if (handlerResult && typeof handlerResult.then === "function") {
-              handlerResult.catch((error) => {
-                res2.setHeader("Connection", "close");
-                this._handleErr?.(error, req2, res2);
-              });
-            }
-            return handlerResult;
           } catch (error) {
             res2.setHeader("Connection", "close");
             this._handleErr?.(error, req2, res2);
           }
         } else {
           try {
-            const middlewareResult = middleware[index](
+            await middleware[index](
               req2,
               res2,
               // The next function
-              (error) => {
+              async (error) => {
                 if (error) {
                   res2.setHeader("Connection", "close");
                   return this._handleErr?.(error, req2, res2);
                 }
-                runHandler(req2, res2, middleware, cb, index + 1);
+                await runHandler(req2, res2, middleware, cb, index + 1);
               },
               // Error handler for a route middleware
               (error) => {
@@ -240,38 +299,50 @@ var Cpeak = class {
                 this._handleErr?.(error, req2, res2);
               }
             );
-            if (middlewareResult && typeof middlewareResult.then === "function") {
-              middlewareResult.catch((error) => {
-                res2.setHeader("Connection", "close");
-                this._handleErr?.(error, req2, res2);
-              });
-            }
           } catch (error) {
             res2.setHeader("Connection", "close");
             this._handleErr?.(error, req2, res2);
           }
         }
       };
-      const runMiddleware = (req2, res2, middleware, index) => {
+      const runMiddleware = async (req2, res2, middleware, index) => {
         if (index === middleware.length) {
           const routes = this.routes[req2.method?.toLowerCase() || ""];
           if (routes && typeof routes[Symbol.iterator] === "function")
             for (const route of routes) {
-              const match = urlWithoutParams?.match(route.regex);
+              const match = urlWithoutQueries?.match(route.regex);
               if (match) {
-                const vars = this.#extractVars(route.path, match);
-                req2.vars = vars;
-                return runHandler(req2, res2, route.middleware, route.cb, 0);
+                const pathVariables = this.#extractPathVariables(
+                  route.path,
+                  match
+                );
+                req2.params = pathVariables;
+                return await runHandler(
+                  req2,
+                  res2,
+                  route.middleware,
+                  route.cb,
+                  0
+                );
               }
             }
-          return res2.status(404).json({ error: `Cannot ${req2.method} ${urlWithoutParams}` });
+          return res2.status(404).json({ error: `Cannot ${req2.method} ${urlWithoutQueries}` });
         } else {
-          middleware[index](req2, res2, () => {
-            runMiddleware(req2, res2, middleware, index + 1);
-          });
+          try {
+            await middleware[index](req2, res2, async (err) => {
+              if (err) {
+                res2.setHeader("Connection", "close");
+                return this._handleErr?.(err, req2, res2);
+              }
+              await runMiddleware(req2, res2, middleware, index + 1);
+            });
+          } catch (error) {
+            res2.setHeader("Connection", "close");
+            this._handleErr?.(error, req2, res2);
+          }
         }
       };
-      runMiddleware(req, res, this.middleware, 0);
+      await runMiddleware(req, res, this.middleware, 0);
     });
   }
   route(method, path2, ...args) {
@@ -300,23 +371,23 @@ var Cpeak = class {
   // PRIVATE METHODS:
   // ------------------------------
   #pathToRegex(path2) {
-    const varNames = [];
+    const paramNames = [];
     const regexString = "^" + path2.replace(/:\w+/g, (match, offset) => {
-      varNames.push(match.slice(1));
+      paramNames.push(match.slice(1));
       return "([^/]+)";
     }) + "$";
     const regex = new RegExp(regexString);
     return regex;
   }
-  #extractVars(path2, match) {
-    const varNames = (path2.match(/:\w+/g) || []).map(
-      (varParam) => varParam.slice(1)
+  #extractPathVariables(path2, match) {
+    const paramNames = (path2.match(/:\w+/g) || []).map(
+      (param) => param.slice(1)
     );
-    const vars = {};
-    varNames.forEach((name, index) => {
-      vars[name] = match[index + 1];
+    const params = {};
+    paramNames.forEach((name, index) => {
+      params[name] = match[index + 1];
     });
-    return vars;
+    return params;
   }
 };
 function cpeak() {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../lib/index.ts","../lib/utils/serveStatic.ts","../lib/utils/parseJSON.ts","../lib/utils/render.ts"],"sourcesContent":["import http from \"node:http\";\nimport fs from \"node:fs/promises\";\nimport { createReadStream } from \"node:fs\";\nimport { pipeline } from \"node:stream/promises\";\n\nimport type {\n  StringMap,\n  CpeakRequest,\n  CpeakResponse,\n  Middleware,\n  RouteMiddleware,\n  Handler,\n  RoutesMap,\n} from \"./types\";\n\n// A utility function to create an error with a custom stack trace\nexport function frameworkError(\n  message: string,\n  skipFn: Function,\n  code?: string\n) {\n  const err = new Error(message) as Error & { code?: string };\n  Error.captureStackTrace(err, skipFn);\n\n  if (code) err.code = code;\n\n  return err;\n}\n\nexport enum ErrorCode {\n  MISSING_MIME = \"CPEAK_ERR_MISSING_MIME\",\n  FILE_NOT_FOUND = \"CPEAK_ERR_FILE_NOT_FOUND\",\n  NOT_A_FILE = \"CPEAK_ERR_NOT_A_FILE\",\n  SEND_FILE_FAIL = \"CPEAK_ERR_SEND_FILE_FAIL\",\n}\n\nclass Cpeak {\n  private server: http.Server;\n  private routes: RoutesMap;\n  private middleware: Middleware[];\n  private _handleErr?: (\n    err: unknown,\n    req: CpeakRequest,\n    res: CpeakResponse\n  ) => void;\n\n  constructor() {\n    this.server = http.createServer();\n    this.routes = {};\n    this.middleware = [];\n\n    this.server.on(\"request\", (req: CpeakRequest, res: CpeakResponse) => {\n      // Send a file back to the client\n      res.sendFile = async (path: string, mime: string) => {\n        if (!mime) {\n          throw frameworkError(\n            'MIME type is missing. Use res.sendFile(path, \"mime-type\").',\n            res.sendFile,\n            ErrorCode.MISSING_MIME\n          );\n        }\n\n        try {\n          const stat = await fs.stat(path);\n          if (!stat.isFile()) {\n            throw frameworkError(\n              `Not a file: ${path}`,\n              res.sendFile,\n              ErrorCode.NOT_A_FILE\n            );\n          }\n\n          res.setHeader(\"Content-Type\", mime);\n          res.setHeader(\"Content-Length\", String(stat.size));\n\n          // Properly propagate stream errors and respect backpressure\n          await pipeline(createReadStream(path), res);\n        } catch (err: any) {\n          if (err?.code === \"ENOENT\") {\n            throw frameworkError(\n              `File not found: ${path}`,\n              res.sendFile,\n              ErrorCode.FILE_NOT_FOUND\n            );\n          }\n\n          throw frameworkError(\n            `Failed to send file: ${path}`,\n            res.sendFile,\n            ErrorCode.SEND_FILE_FAIL\n          );\n        }\n      };\n\n      // Set the status code of the response\n      res.status = (code: number) => {\n        res.statusCode = code;\n        return res;\n      };\n\n      // Redirects to a new URL\n      res.redirect = (location: string) => {\n        res.writeHead(302, { Location: location });\n        res.end();\n        return res;\n      };\n\n      // Send a json data back to the client (for small json data, less than the highWaterMark)\n      res.json = (data: any) => {\n        // This is only good for bodies that their size is less than the highWaterMark value\n        res.setHeader(\"Content-Type\", \"application/json\");\n        res.end(JSON.stringify(data));\n      };\n\n      // Get the url without the URL parameters\n      const urlWithoutParams = req.url?.split(\"?\")[0];\n\n      // Parse the URL parameters (like /users?key1=value1&key2=value2)\n      // We put this here to also parse them for all the middleware functions\n      const params = new URLSearchParams(req.url?.split(\"?\")[1]);\n\n      const paramsObject = Object.fromEntries(params.entries());\n\n      req.params = paramsObject;\n      req.query = paramsObject; // only for compatibility with frameworks built for express\n\n      // Run all the specific middleware functions for that router only and then run the handler\n      const runHandler = (\n        req: CpeakRequest,\n        res: CpeakResponse,\n        middleware: RouteMiddleware[],\n        cb: Handler,\n        index: number\n      ) => {\n        // Our exit point...\n        if (index === middleware.length) {\n          // Call the route handler with the modified req and res objects.\n          // Also handle the promise errors by passing them to the handleErr to save developers from having to manually wrap every handler in try catch.\n          try {\n            const handlerResult = cb(req, res, (error) => {\n              res.setHeader(\"Connection\", \"close\");\n              this._handleErr?.(error, req, res);\n            });\n\n            if (handlerResult && typeof handlerResult.then === \"function\") {\n              handlerResult.catch((error) => {\n                res.setHeader(\"Connection\", \"close\");\n                this._handleErr?.(error, req, res);\n              });\n            }\n\n            return handlerResult;\n          } catch (error) {\n            res.setHeader(\"Connection\", \"close\");\n            this._handleErr?.(error, req, res);\n          }\n        } else {\n          // Handle the promise errors by passing them to the handleErr to save developers from having to manually wrap every handler middleware in try catch.\n          try {\n            const middlewareResult = middleware[index](\n              req,\n              res,\n              // The next function\n              (error) => {\n                // this function only accepts an error argument to be more compatible with NPM modules that are built for express\n                if (error) {\n                  res.setHeader(\"Connection\", \"close\");\n                  return this._handleErr?.(error, req, res);\n                }\n                runHandler(req, res, middleware, cb, index + 1);\n              },\n              // Error handler for a route middleware\n              (error) => {\n                res.setHeader(\"Connection\", \"close\");\n                this._handleErr?.(error, req, res);\n              }\n            );\n\n            // If the middleware is async, handle the promise rejection\n            if (\n              middlewareResult &&\n              typeof middlewareResult.then === \"function\"\n            ) {\n              middlewareResult.catch((error) => {\n                res.setHeader(\"Connection\", \"close\");\n                this._handleErr?.(error, req, res);\n              });\n            }\n          } catch (error) {\n            res.setHeader(\"Connection\", \"close\");\n            this._handleErr?.(error, req, res);\n          }\n        }\n      };\n\n      // Run all the middleware functions (beforeEach functions) before we run the corresponding route\n      const runMiddleware = (\n        req: CpeakRequest,\n        res: CpeakResponse,\n        middleware: Middleware[],\n        index: number\n      ) => {\n        // Our exit point...\n        if (index === middleware.length) {\n          const routes = this.routes[req.method?.toLowerCase() || \"\"];\n          if (routes && typeof routes[Symbol.iterator] === \"function\")\n            for (const route of routes) {\n              const match = urlWithoutParams?.match(route.regex);\n\n              if (match) {\n                // Parse the URL variables from the matched route (like /users/:id)\n                const vars = this.#extractVars(route.path, match);\n                req.vars = vars;\n\n                return runHandler(req, res, route.middleware, route.cb, 0);\n              }\n            }\n\n          // If the requested route dose not exist, return 404\n          return res\n            .status(404)\n            .json({ error: `Cannot ${req.method} ${urlWithoutParams}` });\n        } else {\n          middleware[index](req, res, () => {\n            runMiddleware(req, res, middleware, index + 1);\n          });\n        }\n      };\n\n      runMiddleware(req, res, this.middleware, 0);\n    });\n  }\n\n  route(method: string, path: string, ...args: (RouteMiddleware | Handler)[]) {\n    if (!this.routes[method]) this.routes[method] = [];\n\n    // The last argument should always be our handler\n    const cb = args.pop() as Handler;\n\n    if (!cb || typeof cb !== \"function\") {\n      throw new Error(\"Route definition must include a handler\");\n    }\n\n    // Rest will be our middleware functions\n    const middleware = args.flat() as RouteMiddleware[];\n\n    const regex = this.#pathToRegex(path);\n    this.routes[method].push({ path, regex, middleware, cb });\n  }\n\n  beforeEach(cb: Middleware) {\n    this.middleware.push(cb);\n  }\n\n  handleErr(cb: (err: unknown, req: CpeakRequest, res: CpeakResponse) => void) {\n    this._handleErr = cb;\n  }\n\n  listen(port: number, cb?: () => void) {\n    return this.server.listen(port, cb);\n  }\n\n  close(cb?: (err?: Error) => void) {\n    this.server.close(cb);\n  }\n\n  // ------------------------------\n  // PRIVATE METHODS:\n  // ------------------------------\n  #pathToRegex(path: string) {\n    const varNames: string[] = [];\n    const regexString =\n      \"^\" +\n      path.replace(/:\\w+/g, (match, offset) => {\n        varNames.push(match.slice(1));\n        return \"([^/]+)\";\n      }) +\n      \"$\";\n\n    const regex = new RegExp(regexString);\n    return regex;\n  }\n\n  #extractVars(path: string, match: RegExpMatchArray) {\n    // Extract url variable values from the matched route\n    const varNames = (path.match(/:\\w+/g) || []).map((varParam) =>\n      varParam.slice(1)\n    );\n    const vars: StringMap = {};\n    varNames.forEach((name, index) => {\n      vars[name] = match[index + 1];\n    });\n    return vars;\n  }\n}\n\n// Util functions\nexport { serveStatic } from \"./utils/serveStatic.js\";\nexport { parseJSON } from \"./utils/parseJSON.js\";\nexport { render } from \"./utils/render.js\";\n\nexport type {\n  Cpeak,\n  CpeakRequest,\n  CpeakResponse,\n  Next,\n  HandleErr,\n  Middleware,\n  RouteMiddleware,\n  Handler,\n  RoutesMap,\n} from \"./types\";\n\nexport default function cpeak() {\n  return new Cpeak();\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport type { StringMap, CpeakRequest, CpeakResponse, Next } from \"../types\";\n\nconst MIME_TYPES: StringMap = {\n  html: \"text/html\",\n  css: \"text/css\",\n  js: \"application/javascript\",\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  svg: \"image/svg+xml\",\n  txt: \"text/plain\",\n  eot: \"application/vnd.ms-fontobject\",\n  otf: \"font/otf\",\n  ttf: \"font/ttf\",\n  woff: \"font/woff\",\n  woff2: \"font/woff2\",\n};\n\nconst serveStatic = (folderPath: string, newMimeTypes?: StringMap) => {\n  // For new user defined mime types\n  if (newMimeTypes) {\n    Object.assign(MIME_TYPES, newMimeTypes);\n  }\n\n  function processFolder(folderPath: string, parentFolder: string) {\n    const staticFiles: string[] = [];\n\n    // Read the contents of the folder\n    const files = fs.readdirSync(folderPath);\n\n    // Loop through the files and subfolders\n    for (const file of files) {\n      const fullPath = path.join(folderPath, file);\n\n      // Check if it's a directory\n      if (fs.statSync(fullPath).isDirectory()) {\n        // If it's a directory, recursively process it\n        const subfolderFiles = processFolder(fullPath, parentFolder);\n        staticFiles.push(...subfolderFiles);\n      } else {\n        // If it's a file, add it to the array\n        const relativePath = path.relative(parentFolder, fullPath);\n        const fileExtension = path.extname(file).slice(1);\n        if (MIME_TYPES[fileExtension]) staticFiles.push(\"/\" + relativePath);\n      }\n    }\n\n    return staticFiles;\n  }\n\n  const filesArrayToFilesMap = (filesArray: string[]) => {\n    const filesMap: Record<string, { path: string; mime: string }> = {};\n    for (const file of filesArray) {\n      const fileExtension = path.extname(file).slice(1);\n      filesMap[file] = {\n        path: folderPath + file,\n        mime: MIME_TYPES[fileExtension],\n      };\n    }\n    return filesMap;\n  };\n\n  // Start processing the folder\n  const filesMap = filesArrayToFilesMap(processFolder(folderPath, folderPath));\n\n  return function (req: CpeakRequest, res: CpeakResponse, next: Next) {\n    const url = req.url;\n    if (typeof url !== \"string\") return next();\n\n    if (Object.prototype.hasOwnProperty.call(filesMap, url)) {\n      const fileRoute = filesMap[url];\n      return res.sendFile(fileRoute.path, fileRoute.mime);\n    }\n\n    next();\n  };\n};\n\nexport { serveStatic };\n","import type { CpeakRequest, CpeakResponse, Next } from \"../types\";\n\n// Parsing JSON\nconst parseJSON = (req: CpeakRequest, res: CpeakResponse, next: Next) => {\n  // This is only good for bodies that their size is less than the highWaterMark value\n\n  function isJSON(contentType: string = \"\") {\n    // Remove any params like \"; charset=UTF-8\"\n    const [type] = contentType.split(\";\");\n    return (\n      type.trim().toLowerCase() === \"application/json\" ||\n      /\\+json$/i.test(type.trim())\n    );\n  }\n\n  if (!isJSON(req.headers[\"content-type\"] as string)) return next();\n\n  let body = \"\";\n  req.on(\"data\", (chunk: Buffer) => {\n    body += chunk.toString(\"utf-8\");\n  });\n\n  req.on(\"end\", () => {\n    body = JSON.parse(body);\n    req.body = body;\n    return next();\n  });\n};\n\nexport { parseJSON };\n","import fs from \"node:fs/promises\";\nimport { frameworkError } from \"../\";\nimport type { CpeakRequest, CpeakResponse, Next } from \"../types\";\n\nfunction renderTemplate(\n  templateStr: string,\n  data: Record<string, unknown>\n): string {\n  // Initialize variables\n  let result: (string | unknown)[] = [];\n\n  let currentIndex = 0;\n\n  while (currentIndex < templateStr.length) {\n    // Find the next opening placeholder\n    const startIdx = templateStr.indexOf(\"{{\", currentIndex);\n    if (startIdx === -1) {\n      // No more placeholders, push the remaining string\n      result.push(templateStr.slice(currentIndex));\n      break;\n    }\n\n    // Push the part before the placeholder\n    result.push(templateStr.slice(currentIndex, startIdx));\n\n    // Find the closing placeholder\n    const endIdx = templateStr.indexOf(\"}}\", startIdx);\n    if (endIdx === -1) {\n      // No closing brace found, treat the rest as plain text\n      result.push(templateStr.slice(startIdx));\n      break;\n    }\n\n    // Extract the variable name\n    const varName = templateStr.slice(startIdx + 2, endIdx).trim();\n\n    // Replace the variable with its value from the data, or use an empty string if not found\n    const replacement = data[varName] !== undefined ? data[varName] : \"\";\n\n    // Push the replacement to the result array\n    result.push(replacement);\n\n    // Move the index past the current closing placeholder\n    currentIndex = endIdx + 2;\n  }\n\n  // Join all parts into a final string\n  return result.join(\"\");\n}\n\n// Errors to return: recommend to not render files larger than 100KB\n// To Explore: Doing the operation in C++ and return the data as stream back to the client\n// @TODO: remove the file from static map\n// @TODO: escape the string to prevent XSS\n// @TODO: add another {{{ }}} option to not escape the string\nconst render = () => {\n  console.log(\"render.ts loaded\");\n  return function (req: CpeakRequest, res: CpeakResponse, next: Next): void {\n    res.render = async (\n      path: string,\n      data: Record<string, unknown>,\n      mime: string\n    ) => {\n      // check if mime is specified, if not return an error\n      if (!mime) {\n        throw frameworkError(\n          `MIME type is missing. You called res.render(\"${path}\", ...) but forgot to provide the third \"mime\" argument.`,\n          res.render\n        );\n      }\n\n      let fileStr = await fs.readFile(path, \"utf-8\");\n      const finalStr = renderTemplate(fileStr, data);\n      res.setHeader(\"Content-Type\", mime);\n      res.end(finalStr);\n    };\n\n    next();\n  };\n};\n\nexport { render };\n"],"mappings":"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","names":["fs","folderPath","filesMap","fs","path","fs","ErrorCode","path","fs","req","res"]}
+{"version":3,"sources":["../lib/index.ts","../lib/utils/serveStatic.ts","../lib/utils/paseJSON.ts","../lib/utils/render.ts"],"sourcesContent":["import http from \"node:http\";\nimport fs from \"node:fs/promises\";\nimport { createReadStream } from \"node:fs\";\nimport { pipeline } from \"node:stream/promises\";\n\nimport type {\n  StringMap,\n  CpeakRequest,\n  CpeakResponse,\n  Middleware,\n  RouteMiddleware,\n  Handler,\n  RoutesMap\n} from \"./types\";\n\n// A utility function to create an error with a custom stack trace\nexport function frameworkError(\n  message: string,\n  skipFn: Function,\n  code?: string,\n  status?: number\n) {\n  const err = new Error(message) as Error & {\n    code?: string;\n    cpeak_err?: boolean;\n  };\n  Error.captureStackTrace(err, skipFn);\n\n  err.cpeak_err = true;\n\n  if (code) err.code = code;\n  if (status) (err as any).status = status;\n\n  return err;\n}\n\nexport enum ErrorCode {\n  MISSING_MIME = \"CPEAK_ERR_MISSING_MIME\",\n  FILE_NOT_FOUND = \"CPEAK_ERR_FILE_NOT_FOUND\",\n  NOT_A_FILE = \"CPEAK_ERR_NOT_A_FILE\",\n  SEND_FILE_FAIL = \"CPEAK_ERR_SEND_FILE_FAIL\",\n  INVALID_JSON = \"CPEAK_ERR_INVALID_JSON\",\n  PAYLOAD_TOO_LARGE = \"CPEAK_ERR_PAYLOAD_TOO_LARGE\"\n}\n\nclass CpeakIncomingMessage extends http.IncomingMessage {\n  // We define body and params here for better V8 optimization (not changing the shape of the object at runtime)\n  public body: any = undefined;\n  public params: StringMap = {};\n\n  private _query?: StringMap;\n\n  // Parse the URL parameters (like /users?key1=value1&key2=value2)\n  // We will call this query to be more familiar with other node.js frameworks.\n  // This is a getter method (accessed like a property)\n  get query(): StringMap {\n    // This way if a developer writes req.query multiple times, we don't parse it multiple times\n    if (this._query) return this._query;\n\n    const url = this.url || \"\";\n    const qIndex = url.indexOf(\"?\");\n\n    if (qIndex === -1) {\n      this._query = {};\n    } else {\n      const searchParams = new URLSearchParams(url.substring(qIndex + 1));\n      this._query = Object.fromEntries(searchParams.entries());\n    }\n\n    return this._query;\n  }\n}\n\nclass CpeakServerResponse extends http.ServerResponse<CpeakIncomingMessage> {\n  // Send a file back to the client\n  async sendFile(path: string, mime: string) {\n    if (!mime) {\n      throw frameworkError(\n        'MIME type is missing. Use res.sendFile(path, \"mime-type\").',\n        this.sendFile,\n        ErrorCode.MISSING_MIME\n      );\n    }\n\n    try {\n      const stat = await fs.stat(path);\n      if (!stat.isFile()) {\n        throw frameworkError(\n          `Not a file: ${path}`,\n          this.sendFile,\n          ErrorCode.NOT_A_FILE\n        );\n      }\n\n      this.setHeader(\"Content-Type\", mime);\n      this.setHeader(\"Content-Length\", String(stat.size));\n\n      // Properly propagate stream errors and respect backpressure\n      await pipeline(createReadStream(path), this);\n    } catch (err: any) {\n      if (err?.code === \"ENOENT\") {\n        throw frameworkError(\n          `File not found: ${path}`,\n          this.sendFile,\n          ErrorCode.FILE_NOT_FOUND\n        );\n      }\n\n      throw frameworkError(\n        `Failed to send file: ${path}`,\n        this.sendFile,\n        ErrorCode.SEND_FILE_FAIL\n      );\n    }\n  }\n\n  // Set the status code of the response\n  status(code: number) {\n    this.statusCode = code;\n    return this;\n  }\n\n  // Redirects to a new URL\n  redirect(location: string) {\n    this.writeHead(302, { Location: location });\n    this.end();\n    return this;\n  }\n\n  // Send a json data back to the client (for small json data, less than the highWaterMark)\n  json(data: any) {\n    // This is only good for bodies that their size is less than the highWaterMark value\n    this.setHeader(\"Content-Type\", \"application/json\");\n    this.end(JSON.stringify(data));\n  }\n}\n\nclass Cpeak {\n  private server: http.Server<\n    typeof CpeakIncomingMessage,\n    typeof CpeakServerResponse\n  >;\n  private routes: RoutesMap;\n  private middleware: Middleware[];\n  private _handleErr?: (\n    err: unknown,\n    req: CpeakRequest,\n    res: CpeakResponse\n  ) => void;\n\n  constructor() {\n    this.server = http.createServer({\n      IncomingMessage: CpeakIncomingMessage,\n      ServerResponse: CpeakServerResponse\n    });\n    this.routes = {};\n    this.middleware = [];\n\n    this.server.on(\"request\", async (req: CpeakRequest, res: CpeakResponse) => {\n      // Get the url without the URL parameters (query strings)\n      const qIndex = req.url?.indexOf(\"?\");\n      const urlWithoutQueries =\n        qIndex === -1 ? req.url || \"\" : req.url?.substring(0, qIndex);\n\n      // Run all the specific middleware functions for that router only and then run the handler\n      const runHandler = async (\n        req: CpeakRequest,\n        res: CpeakResponse,\n        middleware: RouteMiddleware[],\n        cb: Handler,\n        index: number\n      ) => {\n        // Our exit point...\n        if (index === middleware.length) {\n          // Call the route handler with the modified req and res objects.\n          // Also handle the promise errors by passing them to the handleErr to save developers from having to manually wrap every handler in try catch.\n          try {\n            await cb(req, res, (error) => {\n              res.setHeader(\"Connection\", \"close\");\n              this._handleErr?.(error, req, res);\n            });\n          } catch (error) {\n            res.setHeader(\"Connection\", \"close\");\n            this._handleErr?.(error, req, res);\n          }\n        } else {\n          // Handle the promise errors by passing them to the handleErr to save developers from having to manually wrap every handler middleware in try catch.\n          try {\n            await middleware[index](\n              req,\n              res,\n              // The next function\n              async (error) => {\n                // this function only accepts an error argument to be more compatible with NPM modules that are built for express\n                if (error) {\n                  res.setHeader(\"Connection\", \"close\");\n                  return this._handleErr?.(error, req, res);\n                }\n                await runHandler(req, res, middleware, cb, index + 1);\n              },\n              // Error handler for a route middleware\n              (error) => {\n                res.setHeader(\"Connection\", \"close\");\n                this._handleErr?.(error, req, res);\n              }\n            );\n          } catch (error) {\n            res.setHeader(\"Connection\", \"close\");\n            this._handleErr?.(error, req, res);\n          }\n        }\n      };\n\n      // Run all the middleware functions (beforeEach functions) before we run the corresponding route\n      const runMiddleware = async (\n        req: CpeakRequest,\n        res: CpeakResponse,\n        middleware: Middleware[],\n        index: number\n      ) => {\n        // Our exit point...\n        if (index === middleware.length) {\n          const routes = this.routes[req.method?.toLowerCase() || \"\"];\n          if (routes && typeof routes[Symbol.iterator] === \"function\")\n            for (const route of routes) {\n              const match = urlWithoutQueries?.match(route.regex);\n\n              if (match) {\n                // Parse the URL path variables from the matched route (like /users/:id)\n                const pathVariables = this.#extractPathVariables(\n                  route.path,\n                  match\n                );\n\n                // We will call this params to be more familiar with other node.js frameworks.\n                req.params = pathVariables;\n\n                return await runHandler(\n                  req,\n                  res,\n                  route.middleware,\n                  route.cb,\n                  0\n                );\n              }\n            }\n\n          // If the requested route dose not exist, return 404\n          return res\n            .status(404)\n            .json({ error: `Cannot ${req.method} ${urlWithoutQueries}` });\n        } else {\n          try {\n            await middleware[index](req, res, async (err?: unknown) => {\n              if (err) {\n                res.setHeader(\"Connection\", \"close\");\n                return this._handleErr?.(err, req, res);\n              }\n              await runMiddleware(req, res, middleware, index + 1);\n            });\n          } catch (error) {\n            res.setHeader(\"Connection\", \"close\");\n            this._handleErr?.(error, req, res);\n          }\n        }\n      };\n\n      await runMiddleware(req, res, this.middleware, 0);\n    });\n  }\n\n  route(method: string, path: string, ...args: (RouteMiddleware | Handler)[]) {\n    if (!this.routes[method]) this.routes[method] = [];\n\n    // The last argument should always be our handler\n    const cb = args.pop() as Handler;\n\n    if (!cb || typeof cb !== \"function\") {\n      throw new Error(\"Route definition must include a handler\");\n    }\n\n    // Rest will be our middleware functions\n    const middleware = args.flat() as RouteMiddleware[];\n\n    const regex = this.#pathToRegex(path);\n    this.routes[method].push({ path, regex, middleware, cb });\n  }\n\n  beforeEach(cb: Middleware) {\n    this.middleware.push(cb);\n  }\n\n  handleErr(cb: (err: unknown, req: CpeakRequest, res: CpeakResponse) => void) {\n    this._handleErr = cb;\n  }\n\n  listen(port: number, cb?: () => void) {\n    return this.server.listen(port, cb);\n  }\n\n  close(cb?: (err?: Error) => void) {\n    this.server.close(cb);\n  }\n\n  // ------------------------------\n  // PRIVATE METHODS:\n  // ------------------------------\n  #pathToRegex(path: string) {\n    const paramNames: string[] = [];\n    const regexString =\n      \"^\" +\n      path.replace(/:\\w+/g, (match, offset) => {\n        paramNames.push(match.slice(1));\n        return \"([^/]+)\";\n      }) +\n      \"$\";\n\n    const regex = new RegExp(regexString);\n    return regex;\n  }\n\n  #extractPathVariables(path: string, match: RegExpMatchArray) {\n    // Extract path url variable values from the matched route\n    const paramNames = (path.match(/:\\w+/g) || []).map((param) =>\n      param.slice(1)\n    );\n    const params: StringMap = {};\n    paramNames.forEach((name, index) => {\n      params[name] = match[index + 1];\n    });\n    return params;\n  }\n}\n\n// Util functions\nexport { serveStatic } from \"./utils/serveStatic.js\";\nexport { parseJSON } from \"./utils/paseJSON.js\";\nexport { render } from \"./utils/render.js\";\n\nexport type {\n  Cpeak,\n  CpeakRequest,\n  CpeakResponse,\n  Next,\n  HandleErr,\n  Middleware,\n  RouteMiddleware,\n  Handler,\n  RoutesMap\n} from \"./types\";\n\nexport default function cpeak() {\n  return new Cpeak();\n}\n","import fs from \"node:fs\";\nimport path from \"node:path\";\n\nimport type { StringMap, CpeakRequest, CpeakResponse, Next } from \"../types\";\n\nconst MIME_TYPES: StringMap = {\n  html: \"text/html\",\n  css: \"text/css\",\n  js: \"application/javascript\",\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  svg: \"image/svg+xml\",\n  txt: \"text/plain\",\n  eot: \"application/vnd.ms-fontobject\",\n  otf: \"font/otf\",\n  ttf: \"font/ttf\",\n  woff: \"font/woff\",\n  woff2: \"font/woff2\",\n};\n\nconst serveStatic = (folderPath: string, newMimeTypes?: StringMap) => {\n  // For new user defined mime types\n  if (newMimeTypes) {\n    Object.assign(MIME_TYPES, newMimeTypes);\n  }\n\n  function processFolder(folderPath: string, parentFolder: string) {\n    const staticFiles: string[] = [];\n\n    // Read the contents of the folder\n    const files = fs.readdirSync(folderPath);\n\n    // Loop through the files and subfolders\n    for (const file of files) {\n      const fullPath = path.join(folderPath, file);\n\n      // Check if it's a directory\n      if (fs.statSync(fullPath).isDirectory()) {\n        // If it's a directory, recursively process it\n        const subfolderFiles = processFolder(fullPath, parentFolder);\n        staticFiles.push(...subfolderFiles);\n      } else {\n        // If it's a file, add it to the array\n        const relativePath = path.relative(parentFolder, fullPath);\n        const fileExtension = path.extname(file).slice(1);\n        if (MIME_TYPES[fileExtension]) staticFiles.push(\"/\" + relativePath);\n      }\n    }\n\n    return staticFiles;\n  }\n\n  const filesArrayToFilesMap = (filesArray: string[]) => {\n    const filesMap: Record<string, { path: string; mime: string }> = {};\n    for (const file of filesArray) {\n      const fileExtension = path.extname(file).slice(1);\n      filesMap[file] = {\n        path: folderPath + file,\n        mime: MIME_TYPES[fileExtension],\n      };\n    }\n    return filesMap;\n  };\n\n  // Start processing the folder\n  const filesMap = filesArrayToFilesMap(processFolder(folderPath, folderPath));\n\n  return function (req: CpeakRequest, res: CpeakResponse, next: Next) {\n    const url = req.url;\n    if (typeof url !== \"string\") return next();\n\n    if (Object.prototype.hasOwnProperty.call(filesMap, url)) {\n      const fileRoute = filesMap[url];\n      return res.sendFile(fileRoute.path, fileRoute.mime);\n    }\n\n    next();\n  };\n};\n\nexport { serveStatic };\n","import type { CpeakRequest, CpeakResponse, Next } from \"../types\";\nimport { Buffer } from \"node:buffer\";\nimport { frameworkError, ErrorCode } from \"../index\";\n\n// Check if Content-Type is JSON\nfunction isJSON(contentType: string | undefined) {\n  if (!contentType) return false;\n  if (contentType === \"application/json\") return true;\n  return (\n    contentType.startsWith(\"application/json\") || contentType.includes(\"+json\")\n  );\n}\n\n// Parsing JSON\nconst parseJSON = (options: { limit?: number } = {}) => {\n  // Default limit to 1MB\n  const limit = options.limit || 1024 * 1024;\n\n  return (req: CpeakRequest, res: CpeakResponse, next: Next) => {\n    if (!isJSON(req.headers[\"content-type\"])) return next();\n\n    const chunks: Buffer[] = [];\n    let bytesReceived = 0;\n\n    const onData = (chunk: Buffer) => {\n      bytesReceived += chunk.length;\n\n      // To prevent Denial of Service (DoS) attacks, enforce a maximum body size\n      if (bytesReceived > limit) {\n        // Stop listening to data\n        req.pause();\n\n        // Remove listeners so we don't trigger 'end' or more 'data'\n        req.removeListener(\"data\", onData);\n        req.removeListener(\"end\", onEnd);\n\n        next(\n          frameworkError(\n            \"JSON body too large\",\n            onData,\n            ErrorCode.PAYLOAD_TOO_LARGE,\n            413 // HTTP 413 Payload Too Large\n          )\n        );\n\n        return;\n      }\n\n      chunks.push(chunk);\n    };\n\n    const onEnd = () => {\n      try {\n        // For better performance, we concat buffers once, then convert to string\n        // Optimization: If only one chunk exists, avoid the memory copy of concat\n        const rawBody =\n          chunks.length === 1\n            ? chunks[0].toString(\"utf-8\")\n            : Buffer.concat(chunks).toString(\"utf-8\");\n\n        // Handle empty body case\n        req.body = rawBody ? JSON.parse(rawBody) : {};\n\n        next();\n      } catch (err) {\n        // Handle Invalid JSON without crashing\n        next(\n          frameworkError(\n            \"Invalid JSON format\",\n            onEnd,\n            ErrorCode.INVALID_JSON,\n            400 // HTTP 400 Bad Request\n          )\n        );\n      }\n    };\n\n    req.on(\"data\", onData);\n    req.on(\"end\", onEnd);\n  };\n};\n\nexport { parseJSON };\n","import fs from \"node:fs/promises\";\nimport { frameworkError } from \"../\";\nimport type { CpeakRequest, CpeakResponse, Next } from \"../types\";\n\nfunction renderTemplate(\n  templateStr: string,\n  data: Record<string, unknown>\n): string {\n  // Initialize variables\n  let result: (string | unknown)[] = [];\n\n  let currentIndex = 0;\n\n  while (currentIndex < templateStr.length) {\n    // Find the next opening placeholder\n    const startIdx = templateStr.indexOf(\"{{\", currentIndex);\n    if (startIdx === -1) {\n      // No more placeholders, push the remaining string\n      result.push(templateStr.slice(currentIndex));\n      break;\n    }\n\n    // Push the part before the placeholder\n    result.push(templateStr.slice(currentIndex, startIdx));\n\n    // Find the closing placeholder\n    const endIdx = templateStr.indexOf(\"}}\", startIdx);\n    if (endIdx === -1) {\n      // No closing brace found, treat the rest as plain text\n      result.push(templateStr.slice(startIdx));\n      break;\n    }\n\n    // Extract the variable name\n    const varName = templateStr.slice(startIdx + 2, endIdx).trim();\n\n    // Replace the variable with its value from the data, or use an empty string if not found\n    const replacement = data[varName] !== undefined ? data[varName] : \"\";\n\n    // Push the replacement to the result array\n    result.push(replacement);\n\n    // Move the index past the current closing placeholder\n    currentIndex = endIdx + 2;\n  }\n\n  // Join all parts into a final string\n  return result.join(\"\");\n}\n\n// Errors to return: recommend to not render files larger than 100KB\n// To Explore: Doing the operation in C++ and return the data as stream back to the client\n// @TODO: remove the file from static map\n// @TODO: escape the string to prevent XSS\n// @TODO: add another {{{ }}} option to not escape the string\nconst render = () => {\n  return function (req: CpeakRequest, res: CpeakResponse, next: Next): void {\n    res.render = async (\n      path: string,\n      data: Record<string, unknown>,\n      mime: string\n    ) => {\n      // check if mime is specified, if not return an error\n      if (!mime) {\n        throw frameworkError(\n          `MIME type is missing. You called res.render(\"${path}\", ...) but forgot to provide the third \"mime\" argument.`,\n          res.render\n        );\n      }\n\n      let fileStr = await fs.readFile(path, \"utf-8\");\n      const finalStr = renderTemplate(fileStr, data);\n      res.setHeader(\"Content-Type\", mime);\n      res.end(finalStr);\n    };\n\n    next();\n  };\n};\n\nexport { render };\n"],"mappings":"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","names":["fs","folderPath","filesMap","fs","path","fs","ErrorCode","path","fs","req","res"]}

package/lib/index.ts

@@ -10,19 +10,26 @@ import type {
   Middleware,
   RouteMiddleware,
   Handler,
-  RoutesMap,
+  RoutesMap
 } from "./types";
 
 // A utility function to create an error with a custom stack trace
 export function frameworkError(
   message: string,
   skipFn: Function,
-  code?: string
+  code?: string,
+  status?: number
 ) {
-  const err = new Error(message) as Error & { code?: string };
+  const err = new Error(message) as Error & {
+    code?: string;
+    cpeak_err?: boolean;
+  };
   Error.captureStackTrace(err, skipFn);
 
+  err.cpeak_err = true;
+
   if (code) err.code = code;
+  if (status) (err as any).status = status;
 
   return err;
 }
@@ -32,10 +39,107 @@ export enum ErrorCode {
   FILE_NOT_FOUND = "CPEAK_ERR_FILE_NOT_FOUND",
   NOT_A_FILE = "CPEAK_ERR_NOT_A_FILE",
   SEND_FILE_FAIL = "CPEAK_ERR_SEND_FILE_FAIL",
+  INVALID_JSON = "CPEAK_ERR_INVALID_JSON",
+  PAYLOAD_TOO_LARGE = "CPEAK_ERR_PAYLOAD_TOO_LARGE"
+}
+
+class CpeakIncomingMessage extends http.IncomingMessage {
+  // We define body and params here for better V8 optimization (not changing the shape of the object at runtime)
+  public body: any = undefined;
+  public params: StringMap = {};
+
+  private _query?: StringMap;
+
+  // Parse the URL parameters (like /users?key1=value1&key2=value2)
+  // We will call this query to be more familiar with other node.js frameworks.
+  // This is a getter method (accessed like a property)
+  get query(): StringMap {
+    // This way if a developer writes req.query multiple times, we don't parse it multiple times
+    if (this._query) return this._query;
+
+    const url = this.url || "";
+    const qIndex = url.indexOf("?");
+
+    if (qIndex === -1) {
+      this._query = {};
+    } else {
+      const searchParams = new URLSearchParams(url.substring(qIndex + 1));
+      this._query = Object.fromEntries(searchParams.entries());
+    }
+
+    return this._query;
+  }
+}
+
+class CpeakServerResponse extends http.ServerResponse<CpeakIncomingMessage> {
+  // Send a file back to the client
+  async sendFile(path: string, mime: string) {
+    if (!mime) {
+      throw frameworkError(
+        'MIME type is missing. Use res.sendFile(path, "mime-type").',
+        this.sendFile,
+        ErrorCode.MISSING_MIME
+      );
+    }
+
+    try {
+      const stat = await fs.stat(path);
+      if (!stat.isFile()) {
+        throw frameworkError(
+          `Not a file: ${path}`,
+          this.sendFile,
+          ErrorCode.NOT_A_FILE
+        );
+      }
+
+      this.setHeader("Content-Type", mime);
+      this.setHeader("Content-Length", String(stat.size));
+
+      // Properly propagate stream errors and respect backpressure
+      await pipeline(createReadStream(path), this);
+    } catch (err: any) {
+      if (err?.code === "ENOENT") {
+        throw frameworkError(
+          `File not found: ${path}`,
+          this.sendFile,
+          ErrorCode.FILE_NOT_FOUND
+        );
+      }
+
+      throw frameworkError(
+        `Failed to send file: ${path}`,
+        this.sendFile,
+        ErrorCode.SEND_FILE_FAIL
+      );
+    }
+  }
+
+  // Set the status code of the response
+  status(code: number) {
+    this.statusCode = code;
+    return this;
+  }
+
+  // Redirects to a new URL
+  redirect(location: string) {
+    this.writeHead(302, { Location: location });
+    this.end();
+    return this;
+  }
+
+  // Send a json data back to the client (for small json data, less than the highWaterMark)
+  json(data: any) {
+    // This is only good for bodies that their size is less than the highWaterMark value
+    this.setHeader("Content-Type", "application/json");
+    this.end(JSON.stringify(data));
+  }
 }
 
 class Cpeak {
-  private server: http.Server;
+  private server: http.Server<
+    typeof CpeakIncomingMessage,
+    typeof CpeakServerResponse
+  >;
   private routes: RoutesMap;
   private middleware: Middleware[];
   private _handleErr?: (
@@ -45,87 +149,21 @@ class Cpeak {
   ) => void;
 
   constructor() {
-    this.server = http.createServer();
+    this.server = http.createServer({
+      IncomingMessage: CpeakIncomingMessage,
+      ServerResponse: CpeakServerResponse
+    });
     this.routes = {};
     this.middleware = [];
 
-    this.server.on("request", (req: CpeakRequest, res: CpeakResponse) => {
-      // Send a file back to the client
-      res.sendFile = async (path: string, mime: string) => {
-        if (!mime) {
-          throw frameworkError(
-            'MIME type is missing. Use res.sendFile(path, "mime-type").',
-            res.sendFile,
-            ErrorCode.MISSING_MIME
-          );
-        }
-
-        try {
-          const stat = await fs.stat(path);
-          if (!stat.isFile()) {
-            throw frameworkError(
-              `Not a file: ${path}`,
-              res.sendFile,
-              ErrorCode.NOT_A_FILE
-            );
-          }
-
-          res.setHeader("Content-Type", mime);
-          res.setHeader("Content-Length", String(stat.size));
-
-          // Properly propagate stream errors and respect backpressure
-          await pipeline(createReadStream(path), res);
-        } catch (err: any) {
-          if (err?.code === "ENOENT") {
-            throw frameworkError(
-              `File not found: ${path}`,
-              res.sendFile,
-              ErrorCode.FILE_NOT_FOUND
-            );
-          }
-
-          throw frameworkError(
-            `Failed to send file: ${path}`,
-            res.sendFile,
-            ErrorCode.SEND_FILE_FAIL
-          );
-        }
-      };
-
-      // Set the status code of the response
-      res.status = (code: number) => {
-        res.statusCode = code;
-        return res;
-      };
-
-      // Redirects to a new URL
-      res.redirect = (location: string) => {
-        res.writeHead(302, { Location: location });
-        res.end();
-        return res;
-      };
-
-      // Send a json data back to the client (for small json data, less than the highWaterMark)
-      res.json = (data: any) => {
-        // This is only good for bodies that their size is less than the highWaterMark value
-        res.setHeader("Content-Type", "application/json");
-        res.end(JSON.stringify(data));
-      };
-
-      // Get the url without the URL parameters
-      const urlWithoutParams = req.url?.split("?")[0];
-
-      // Parse the URL parameters (like /users?key1=value1&key2=value2)
-      // We put this here to also parse them for all the middleware functions
-      const params = new URLSearchParams(req.url?.split("?")[1]);
-
-      const paramsObject = Object.fromEntries(params.entries());
-
-      req.params = paramsObject;
-      req.query = paramsObject; // only for compatibility with frameworks built for express
+    this.server.on("request", async (req: CpeakRequest, res: CpeakResponse) => {
+      // Get the url without the URL parameters (query strings)
+      const qIndex = req.url?.indexOf("?");
+      const urlWithoutQueries =
+        qIndex === -1 ? req.url || "" : req.url?.substring(0, qIndex);
 
       // Run all the specific middleware functions for that router only and then run the handler
-      const runHandler = (
+      const runHandler = async (
         req: CpeakRequest,
         res: CpeakResponse,
         middleware: RouteMiddleware[],
@@ -137,19 +175,10 @@ class Cpeak {
           // Call the route handler with the modified req and res objects.
           // Also handle the promise errors by passing them to the handleErr to save developers from having to manually wrap every handler in try catch.
           try {
-            const handlerResult = cb(req, res, (error) => {
+            await cb(req, res, (error) => {
               res.setHeader("Connection", "close");
               this._handleErr?.(error, req, res);
             });
-
-            if (handlerResult && typeof handlerResult.then === "function") {
-              handlerResult.catch((error) => {
-                res.setHeader("Connection", "close");
-                this._handleErr?.(error, req, res);
-              });
-            }
-
-            return handlerResult;
           } catch (error) {
             res.setHeader("Connection", "close");
             this._handleErr?.(error, req, res);
@@ -157,17 +186,17 @@ class Cpeak {
         } else {
           // Handle the promise errors by passing them to the handleErr to save developers from having to manually wrap every handler middleware in try catch.
           try {
-            const middlewareResult = middleware[index](
+            await middleware[index](
               req,
               res,
               // The next function
-              (error) => {
+              async (error) => {
                 // this function only accepts an error argument to be more compatible with NPM modules that are built for express
                 if (error) {
                   res.setHeader("Connection", "close");
                   return this._handleErr?.(error, req, res);
                 }
-                runHandler(req, res, middleware, cb, index + 1);
+                await runHandler(req, res, middleware, cb, index + 1);
               },
               // Error handler for a route middleware
               (error) => {
@@ -175,17 +204,6 @@ class Cpeak {
                 this._handleErr?.(error, req, res);
               }
             );
-
-            // If the middleware is async, handle the promise rejection
-            if (
-              middlewareResult &&
-              typeof middlewareResult.then === "function"
-            ) {
-              middlewareResult.catch((error) => {
-                res.setHeader("Connection", "close");
-                this._handleErr?.(error, req, res);
-              });
-            }
           } catch (error) {
             res.setHeader("Connection", "close");
             this._handleErr?.(error, req, res);
@@ -194,7 +212,7 @@ class Cpeak {
       };
 
       // Run all the middleware functions (beforeEach functions) before we run the corresponding route
-      const runMiddleware = (
+      const runMiddleware = async (
         req: CpeakRequest,
         res: CpeakResponse,
         middleware: Middleware[],
@@ -205,29 +223,49 @@ class Cpeak {
           const routes = this.routes[req.method?.toLowerCase() || ""];
           if (routes && typeof routes[Symbol.iterator] === "function")
             for (const route of routes) {
-              const match = urlWithoutParams?.match(route.regex);
+              const match = urlWithoutQueries?.match(route.regex);
 
               if (match) {
-                // Parse the URL variables from the matched route (like /users/:id)
-                const vars = this.#extractVars(route.path, match);
-                req.vars = vars;
-
-                return runHandler(req, res, route.middleware, route.cb, 0);
+                // Parse the URL path variables from the matched route (like /users/:id)
+                const pathVariables = this.#extractPathVariables(
+                  route.path,
+                  match
+                );
+
+                // We will call this params to be more familiar with other node.js frameworks.
+                req.params = pathVariables;
+
+                return await runHandler(
+                  req,
+                  res,
+                  route.middleware,
+                  route.cb,
+                  0
+                );
               }
             }
 
           // If the requested route dose not exist, return 404
           return res
             .status(404)
-            .json({ error: `Cannot ${req.method} ${urlWithoutParams}` });
+            .json({ error: `Cannot ${req.method} ${urlWithoutQueries}` });
         } else {
-          middleware[index](req, res, () => {
-            runMiddleware(req, res, middleware, index + 1);
-          });
+          try {
+            await middleware[index](req, res, async (err?: unknown) => {
+              if (err) {
+                res.setHeader("Connection", "close");
+                return this._handleErr?.(err, req, res);
+              }
+              await runMiddleware(req, res, middleware, index + 1);
+            });
+          } catch (error) {
+            res.setHeader("Connection", "close");
+            this._handleErr?.(error, req, res);
+          }
         }
       };
 
-      runMiddleware(req, res, this.middleware, 0);
+      await runMiddleware(req, res, this.middleware, 0);
     });
   }
 
@@ -268,11 +306,11 @@ class Cpeak {
   // PRIVATE METHODS:
   // ------------------------------
   #pathToRegex(path: string) {
-    const varNames: string[] = [];
+    const paramNames: string[] = [];
     const regexString =
       "^" +
       path.replace(/:\w+/g, (match, offset) => {
-        varNames.push(match.slice(1));
+        paramNames.push(match.slice(1));
         return "([^/]+)";
       }) +
       "$";
@@ -281,22 +319,22 @@ class Cpeak {
     return regex;
   }
 
-  #extractVars(path: string, match: RegExpMatchArray) {
-    // Extract url variable values from the matched route
-    const varNames = (path.match(/:\w+/g) || []).map((varParam) =>
-      varParam.slice(1)
+  #extractPathVariables(path: string, match: RegExpMatchArray) {
+    // Extract path url variable values from the matched route
+    const paramNames = (path.match(/:\w+/g) || []).map((param) =>
+      param.slice(1)
     );
-    const vars: StringMap = {};
-    varNames.forEach((name, index) => {
-      vars[name] = match[index + 1];
+    const params: StringMap = {};
+    paramNames.forEach((name, index) => {
+      params[name] = match[index + 1];
     });
-    return vars;
+    return params;
   }
 }
 
 // Util functions
 export { serveStatic } from "./utils/serveStatic.js";
-export { parseJSON } from "./utils/parseJSON.js";
+export { parseJSON } from "./utils/paseJSON.js";
 export { render } from "./utils/render.js";
 
 export type {
@@ -308,7 +346,7 @@ export type {
   Middleware,
   RouteMiddleware,
   Handler,
-  RoutesMap,
+  RoutesMap
 } from "./types";
 
 export default function cpeak() {

package/lib/types.ts

@@ -6,15 +6,15 @@ export type Cpeak = ReturnType<typeof cpeak>;
 // Extending Node.js's Request and Response objects to add our custom properties
 export type StringMap = Record<string, string>;
 
-export interface CpeakRequest<ReqBody = any, ReqParams = any>
-  extends IncomingMessage {
-  params: ReqParams;
-  vars?: StringMap;
+export interface CpeakRequest<
+  ReqBody = any,
+  ReqQueries = any
+> extends IncomingMessage {
+  params: StringMap;
+  query: ReqQueries;
+  // vars?: StringMap;
   body?: ReqBody;
   [key: string]: any; // allow developers to add their onw extensions (e.g. req.test)
-
-  // For express frameworks compatibility:
-  query: ReqParams;
 }
 
 export interface CpeakResponse extends ServerResponse {

package/lib/utils/paseJSON.ts

@@ -0,0 +1,83 @@
+import type { CpeakRequest, CpeakResponse, Next } from "../types";
+import { Buffer } from "node:buffer";
+import { frameworkError, ErrorCode } from "../index";
+
+// Check if Content-Type is JSON
+function isJSON(contentType: string | undefined) {
+  if (!contentType) return false;
+  if (contentType === "application/json") return true;
+  return (
+    contentType.startsWith("application/json") || contentType.includes("+json")
+  );
+}
+
+// Parsing JSON
+const parseJSON = (options: { limit?: number } = {}) => {
+  // Default limit to 1MB
+  const limit = options.limit || 1024 * 1024;
+
+  return (req: CpeakRequest, res: CpeakResponse, next: Next) => {
+    if (!isJSON(req.headers["content-type"])) return next();
+
+    const chunks: Buffer[] = [];
+    let bytesReceived = 0;
+
+    const onData = (chunk: Buffer) => {
+      bytesReceived += chunk.length;
+
+      // To prevent Denial of Service (DoS) attacks, enforce a maximum body size
+      if (bytesReceived > limit) {
+        // Stop listening to data
+        req.pause();
+
+        // Remove listeners so we don't trigger 'end' or more 'data'
+        req.removeListener("data", onData);
+        req.removeListener("end", onEnd);
+
+        next(
+          frameworkError(
+            "JSON body too large",
+            onData,
+            ErrorCode.PAYLOAD_TOO_LARGE,
+            413 // HTTP 413 Payload Too Large
+          )
+        );
+
+        return;
+      }
+
+      chunks.push(chunk);
+    };
+
+    const onEnd = () => {
+      try {
+        // For better performance, we concat buffers once, then convert to string
+        // Optimization: If only one chunk exists, avoid the memory copy of concat
+        const rawBody =
+          chunks.length === 1
+            ? chunks[0].toString("utf-8")
+            : Buffer.concat(chunks).toString("utf-8");
+
+        // Handle empty body case
+        req.body = rawBody ? JSON.parse(rawBody) : {};
+
+        next();
+      } catch (err) {
+        // Handle Invalid JSON without crashing
+        next(
+          frameworkError(
+            "Invalid JSON format",
+            onEnd,
+            ErrorCode.INVALID_JSON,
+            400 // HTTP 400 Bad Request
+          )
+        );
+      }
+    };
+
+    req.on("data", onData);
+    req.on("end", onEnd);
+  };
+};
+
+export { parseJSON };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cpeak",
-  "version": "2.4.3",
+  "version": "2.5.0",
   "description": "A minimal and fast Node.js HTTP framework.",
   "type": "module",
   "scripts": {

package/lib/utils/parseJSON.ts

@@ -1,30 +0,0 @@
-import type { CpeakRequest, CpeakResponse, Next } from "../types";
-
-// Parsing JSON
-const parseJSON = (req: CpeakRequest, res: CpeakResponse, next: Next) => {
-  // This is only good for bodies that their size is less than the highWaterMark value
-
-  function isJSON(contentType: string = "") {
-    // Remove any params like "; charset=UTF-8"
-    const [type] = contentType.split(";");
-    return (
-      type.trim().toLowerCase() === "application/json" ||
-      /\+json$/i.test(type.trim())
-    );
-  }
-
-  if (!isJSON(req.headers["content-type"] as string)) return next();
-
-  let body = "";
-  req.on("data", (chunk: Buffer) => {
-    body += chunk.toString("utf-8");
-  });
-
-  req.on("end", () => {
-    body = JSON.parse(body);
-    req.body = body;
-    return next();
-  });
-};
-
-export { parseJSON };