@increase21/simplenodejs 1.0.24 → 1.0.25

package/README.md

@@ -271,12 +271,44 @@ Parses the request body. Must be registered before controllers access `this.body
 | Param | Type | Description |
 |---|---|---|
 | `limit` | `string \| number` | Max body size (e.g. `"2mb"`, `"500kb"`, or bytes as number). Default: `"1mb"` |
+| `ignoreStream` | `string[] \| (req) => boolean` | Skip stream reading and pass the raw stream to the handler for matching requests. Accepts a list of path prefixes or a predicate function. |
 
 ```ts
 app.use(SetBodyParser({ limit: "2mb" }));
 ```
 
-> Multipart/form-data bodies are not buffered into memory — the size limit still applies to prevent oversized uploads.
+**`ignoreStream` — file upload / raw stream endpoints**
+
+For context where you need direct stream access (e.g. passing the request to a library like `formidable`), use `ignoreStream`:
+
+```ts
+// Path-prefix list — skip body parsing for any URL under /upload
+app.use(SetBodyParser({ limit: "10mb", ignoreStream: ["/upload", "/files"] }));
+
+// Predicate function — full control over which requests are skipped
+app.use(SetBodyParser({
+  limit: "10mb",
+  ignoreStream: (req) => req.url.startsWith("/upload"),
+}));
+```
+
+When a request is ignored, `next()` is called immediately with the stream untouched. Your handler is then responsible for consuming it:
+
+```ts
+import formidable from "formidable";
+
+// Inside your route handler
+const form = formidable({ maxTotalFileSize: 10 * 1024 * 1024 });
+form.parse(req, (err, fields, files) => {
+  if (err) {
+    // err.code 1009 = file too large, 1015 = total too large
+    if (err.code === 1009 || err.code === 1015)
+      return res.status(413).end("Payload Too Large");
+    return res.status(400).end("Upload Error");
+  }
+  res.json({ fields, files });
+});
+```
 
 ---
 

package/dist/typings/simpletypes.d.ts

@@ -7,6 +7,12 @@ export type SimpleJSRateLimitType = {
 };
 export type SimpleJSBodyParseType = {
     limit?: string | number;
+    /**
+     * Skip stream reading (and pass the raw stream to the handler) for matching requests.
+     * Accepts a list of path prefixes or a predicate function.
+     * Multipart requests are always skipped regardless of this option.
+     */
+    ignoreStream?: string[] | ((req: any) => boolean);
 };
 export interface SimpleJsControllerMeta {
     name: string;

package/dist/utils/simpleMiddleware.js

@@ -186,10 +186,20 @@ function SetBodyParser(opts) {
     const maxSize = SetBodyLimit(opts.limit);
     return (req, res, next) => new Promise((resolve, reject) => {
         const contentType = req.headers["content-type"] || "";
-        const isMultipart = contentType.includes("multipart/form-data");
+        const shouldIgnoreStream = (() => {
+            if (!opts.ignoreStream)
+                return false;
+            if (typeof opts.ignoreStream === "function")
+                return opts.ignoreStream(req);
+            const url = req.url || "";
+            return opts.ignoreStream.some(p => url === p || url.startsWith(p));
+        })();
+        // For simplicity, we only parse JSON and plain text. Multipart/form-data and other types are ignored.
+        if (shouldIgnoreStream)
+            return resolve(next());
         let size = 0;
         let body = "";
-        !isMultipart && req.on("data", chunk => {
+        req.on("data", chunk => {
             size += chunk.length;
             if (maxSize && size > maxSize) {
                 reject({ code: 413, error: "Payload Too Large" });
@@ -205,10 +215,10 @@ function SetBodyParser(opts) {
             if (res.writableEnded)
                 return resolve();
             try {
-                if (!isMultipart && body && contentType.includes("application/json")) {
+                if (body && contentType.includes("application/json")) {
                     req.body = JSON.parse(body);
                 }
-                else if (!isMultipart) {
+                else {
                     req.body = body;
                 }
                 resolve(next());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@increase21/simplenodejs",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "Lightweight Node.js HTTP framework with middlewares and plugins",
   "dev": "dist/index.js",
   "bugs": "https://github.com/increase21/simplenodejs/issues",