sprint-es 0.0.156 → 0.0.157

package/dist/cjs/index.cjs

@@ -29,6 +29,8 @@ const cors = require("cors");
 const path = require("path");
 const morgan = require("morgan");
 const dotenv = require("dotenv");
+const multer = require("multer");
+const busboy = require("busboy");
 const url = require("url");
 const rateLimit = require("toolkitify/rate-limit");
 const modules_schemas_index = require("./modules/schemas/index.cjs");
@@ -85,10 +87,7 @@ const isProduction = isProd;
 function isEnabledInEnv(value) {
   if (value === void 0) return false;
   if (typeof value === "boolean") return value;
-  if (Array.isArray(value)) {
-    const env = nodeEnv || "development";
-    return value.includes(env);
-  }
+  if (Array.isArray(value)) return value.includes(nodeEnv || "development");
   return false;
 }
 async function findProjectRoot(startDir) {
@@ -146,6 +145,7 @@ class Sprint {
     };
     this.graphqlSchema = null;
     this.registeredRoutes = [];
+    this.fileMemoryUploadedLimit = 5 * 1024 * 1024;
     this.app = express();
     loadSprintConfig().then((config) => {
       const defaults = {
@@ -194,6 +194,7 @@ class Sprint {
           path: finalConfig.graphql?.graphiql?.path || "/graphiql"
         }
       };
+      this.fileMemoryUploadedLimit = finalConfig.fileMemoryUploadedLimit || 5 * 1024 * 1024;
       const openApiPath = this.openapi.path;
       const swaggerPath = this.openapi.swaggerUi.path;
       const graphqlPath = this.graphql.path;
@@ -219,6 +220,10 @@ class Sprint {
       this.loadDefaults();
       this.loadHealthcheck();
       this.routesLoaded = this.init();
+      this.memoryUpload = multer({
+        storage: multer.memoryStorage(),
+        limits: { fileSize: this.fileMemoryUploadedLimit }
+      });
       this.routesLoaded.then(async () => {
         if (this.openapi.generateOnBuild) {
           this.app.get(this.openapi.path, (_, res) => {
@@ -350,7 +355,7 @@ class Sprint {
     this.app.use(express.urlencoded({ limit: this.urlEncodedLimit, extended: false }));
   }
   /**
-   * Gets all matching middlewares for a given route path, sorted by priority
+   * Gets all matching middlewares for a given route path, sorted by priority.
    */
   getMiddlewaresForRoute(routePath) {
     const matched = [];
@@ -374,7 +379,7 @@ class Sprint {
     return matched.map((m) => m.handler);
   }
   /**
-   * Load all middleware files from the middlewares folder
+   * Load all middleware files from the middlewares folder.
    */
   async loadMiddlewares(middlewaresPath) {
     const fileExtensions = isProd ? [".mjs", ".js"] : [".ts"];
@@ -459,11 +464,37 @@ class Sprint {
                 }
               }
               const routeMiddlewares = this.getMiddlewaresForRoute(routePath);
+              let fileUploadMiddleware = null;
+              for (const layer of router.stack) {
+                if (!layer.route) continue;
+                for (const routeLayer of layer.route.stack) {
+                  const handler = routeLayer.handle;
+                  const handlerSchema = handler.__sprintRouteSchema;
+                  if (handlerSchema?.files && typeof handlerSchema.files === "object" && "field" in handlerSchema.files) {
+                    const fileConfig = handlerSchema.files;
+                    if (fileConfig.maxCount) {
+                      fileUploadMiddleware = this.uploadFiles(fileConfig.field);
+                    } else {
+                      fileUploadMiddleware = this.uploadFile(fileConfig.field);
+                    }
+                    break;
+                  }
+                }
+                if (fileUploadMiddleware) break;
+              }
               if (routeMiddlewares.length > 0) {
-                this.app.use(finalRoute, ...routeMiddlewares, router);
+                if (fileUploadMiddleware) {
+                  this.app.use(finalRoute, fileUploadMiddleware, ...routeMiddlewares, router);
+                } else {
+                  this.app.use(finalRoute, ...routeMiddlewares, router);
+                }
                 if (isVerbose) console.log(`[Sprint] Loaded route: ${finalRoute} -> ${filePath} (with ${routeMiddlewares.length} middleware(s))`);
               } else {
-                this.app.use(finalRoute, router);
+                if (fileUploadMiddleware) {
+                  this.app.use(finalRoute, fileUploadMiddleware, router);
+                } else {
+                  this.app.use(finalRoute, router);
+                }
                 if (isVerbose) console.log(`[Sprint] Loaded route: ${finalRoute} -> ${filePath}`);
               }
               this.counters.routes += router.stack.length;
@@ -828,6 +859,44 @@ class Sprint {
     tryListen(basePort);
     if (callback) callback();
   }
+  uploadFile(fieldName = "file") {
+    return this.memoryUpload.single(fieldName);
+  }
+  uploadFiles(fieldNames = "files") {
+    if (Array.isArray(fieldNames)) return this.memoryUpload.fields(fieldNames.map((name) => ({ name })));
+    return this.memoryUpload.array(fieldNames);
+  }
+  streamUpload(options) {
+    return (req, res) => {
+      return new Promise((resolve, reject) => {
+        const bb = busboy({
+          headers: req.headers,
+          limits: options?.limits
+        });
+        const files = [];
+        const fields = {};
+        bb.on("file", (fieldName, file, info) => {
+          files.push({
+            fieldName,
+            file,
+            filename: info.filename,
+            encoding: info.encoding,
+            mimeType: info.mimeType
+          });
+        });
+        bb.on("field", (fieldName, val) => {
+          fields[fieldName] = val;
+        });
+        bb.on("finish", () => {
+          resolve({ files, fields });
+        });
+        bb.on("error", (err) => {
+          reject(err);
+        });
+        req.pipe(bb);
+      });
+    };
+  }
 }
 function createSchemaValidationMiddleware(schema) {
   const headersSchema = schema.headers ? modules_schemas_index.normalizeHeadersSchema(schema.headers) : null;

package/dist/cjs/modules/schemas/index.cjs

@@ -1,6 +1,110 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const zod = require("zod");
+function normalizeExtensions(ext) {
+  if (!ext) return [];
+  return (Array.isArray(ext) ? ext : [ext]).map((e) => e.toLowerCase().startsWith(".") ? e.toLowerCase() : `.${e.toLowerCase()}`);
+}
+function normalizeMimeTypes(mime) {
+  if (!mime) return [];
+  return (Array.isArray(mime) ? mime : [mime]).map((m) => m.toLowerCase());
+}
+function createFileSchema(options = {}) {
+  const extensions = normalizeExtensions(options.ext);
+  const mimeTypes = normalizeMimeTypes(options.mimeType);
+  const fileSchema = zod.z.object({
+    fieldname: zod.z.string(),
+    originalname: zod.z.string(),
+    encoding: zod.z.string(),
+    mimetype: zod.z.string(),
+    size: zod.z.number(),
+    buffer: zod.z.instanceof(Buffer).optional()
+  });
+  return fileSchema.refine((file) => {
+    if (extensions.length === 0) return true;
+    const fileExt = file.originalname.toLowerCase().substring(file.originalname.lastIndexOf("."));
+    return extensions.includes(fileExt);
+  }, {
+    message: `Invalid file extension. Allowed: ${extensions.join(", ")}`,
+    path: ["originalname"]
+  }).refine((file) => {
+    if (mimeTypes.length === 0) return true;
+    return mimeTypes.includes(file.mimetype.toLowerCase());
+  }, {
+    message: `Invalid mime type. Allowed: ${mimeTypes.join(", ")}`,
+    path: ["mimetype"]
+  }).refine((file) => {
+    if (options.maxSize === void 0) return true;
+    return file.size <= options.maxSize;
+  }, {
+    message: `File size exceeds maximum of ${options.maxSize} bytes`,
+    path: ["size"]
+  }).refine((file) => {
+    if (options.minSize === void 0) return true;
+    return file.size >= options.minSize;
+  }, {
+    message: `File size must be at least ${options.minSize} bytes`,
+    path: ["size"]
+  });
+}
+function createFilesArraySchema(fieldName, options = {}) {
+  const fileSchema = createFileSchema({ ...options });
+  return zod.z.array(fileSchema).min(options.required === false ? 0 : 1, {
+    message: options.required === false ? void 0 : `At least one file is required for field "${fieldName}"`
+  });
+}
+const fileValidators = {
+  ext: (ext) => {
+    const extensions = normalizeExtensions(ext);
+    return createFileSchema({ ext: extensions });
+  },
+  mimeType: (mimeType) => {
+    const mimeTypes = normalizeMimeTypes(mimeType);
+    return createFileSchema({ mimeType: mimeTypes });
+  },
+  maxSize: (maxSize) => {
+    return createFileSchema({ maxSize });
+  },
+  minSize: (minSize) => {
+    return createFileSchema({ minSize });
+  },
+  image: () => {
+    return createFileSchema({
+      mimeType: ["image/jpeg", "image/png", "image/gif", "image/webp", "image/svg+xml"],
+      ext: ["jpg", "jpeg", "png", "gif", "webp", "svg"]
+    });
+  },
+  document: () => {
+    return createFileSchema({
+      mimeType: ["application/pdf", "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain"],
+      ext: ["pdf", "doc", "docx", "txt"]
+    });
+  },
+  video: () => {
+    return createFileSchema({
+      mimeType: ["video/mp4", "video/webm", "video/ogg"],
+      ext: ["mp4", "webm", "ogg"]
+    });
+  },
+  audio: () => {
+    return createFileSchema({
+      mimeType: ["audio/mpeg", "audio/wav", "audio/ogg", "audio/webm"],
+      ext: ["mp3", "wav", "ogg", "webm"]
+    });
+  },
+  archive: () => {
+    return createFileSchema({
+      mimeType: ["application/zip", "application/x-rar-compressed", "application/x-7z-compressed"],
+      ext: ["zip", "rar", "7z"]
+    });
+  },
+  any: () => {
+    return createFileSchema({});
+  },
+  field: (fieldName, options) => {
+    return createFilesArraySchema(fieldName, options);
+  }
+};
 function normalizeHeadersSchema(schema) {
   const shape = schema.shape ?? schema._def?.shape?.();
   if (!shape) return schema;
@@ -25,6 +129,7 @@ Object.assign(sprintCallable, sprintAuth);
 const proxyZ = new Proxy(zod.z, {
   get(target, prop) {
     if (prop === "sprint") return sprintCallable;
+    if (prop === "files") return fileValidators;
     return target[prop];
   }
 });
@@ -43,6 +148,7 @@ function parseSchema(schema, data) {
 }
 function defineRouteSchema(schema) {
   const headersSchema = schema.headers ? normalizeHeadersSchema(schema.headers) : null;
+  const fileConfig = typeof schema.files === "object" && "field" in schema.files ? schema.files : null;
   const middleware = (req, res, next) => {
     const errors = [];
     const method = req.method.toUpperCase();
@@ -64,6 +170,24 @@ function defineRouteSchema(schema) {
       const result = headersSchema.safeParse(normalizedHeaders);
       if (!result.success) errors.push(...result.errors.map((e) => ({ location: "headers", ...e })));
     }
+    let filesData = [];
+    if (schema.files) {
+      if (fileConfig) {
+        const fieldFiles = req.file ? [req.file] : [];
+        const multiFiles = req.files?.[fileConfig.field] || [];
+        filesData = [...fieldFiles, ...Array.isArray(multiFiles) ? multiFiles : []];
+        if (fileConfig.maxCount && filesData.length > fileConfig.maxCount) errors.push({ location: "files", path: fileConfig.field, message: `Maximum ${fileConfig.maxCount} files allowed` });
+        if (fileConfig.schema && filesData.length > 0) {
+          const result = parseSchema(fileConfig.schema, filesData);
+          if (!result.success) errors.push(...result.errors.map((e) => ({ location: "files", ...e })));
+        }
+      } else {
+        const filesSchema = schema.files;
+        const reqFiles = req.files || (req.file ? [req.file] : []);
+        const result = parseSchema(filesSchema, reqFiles);
+        if (!result.success) errors.push(...result.errors.map((e) => ({ location: "files", ...e })));
+      }
+    }
     if (schema.sprint?.authorization) {
       const authSchema = schema.sprint.authorization;
       const description = authSchema._def?.description;
@@ -71,9 +195,7 @@ function defineRouteSchema(schema) {
       if (description) {
         try {
           const parsed = JSON.parse(description);
-          if (parsed.__sprintAuthorization && parsed.sources) {
-            sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
-          }
+          if (parsed.__sprintAuthorization && parsed.sources) sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
         } catch {
         }
       }
@@ -105,9 +227,18 @@ function defineRouteSchema(schema) {
     next();
   };
   middleware.__sprintRouteSchema = schema;
+  if (fileConfig) {
+    middleware.applyFileUpload = function(sprint) {
+      if (fileConfig.maxCount) return sprint.uploadFiles(fileConfig.field);
+      return sprint.uploadFile(fileConfig.field);
+    };
+  }
   return middleware;
 }
+exports.createFileSchema = createFileSchema;
+exports.createFilesArraySchema = createFilesArraySchema;
 exports.defineRouteSchema = defineRouteSchema;
+exports.files = fileValidators;
 exports.normalizeHeadersSchema = normalizeHeadersSchema;
 exports.sprint = sprintBuilder;
 exports.z = proxyZ;

package/dist/esm/index.js

@@ -5,6 +5,8 @@ import cors from "cors";
 import path from "path";
 import morgan from "morgan";
 import dotenv from "dotenv";
+import multer from "multer";
+import busboy from "busboy";
 import { pathToFileURL } from "url";
 import { RateLimiter } from "toolkitify/rate-limit";
 import { normalizeHeadersSchema } from "./modules/schemas/index.js";
@@ -60,10 +62,7 @@ const isProduction = isProd;
 function isEnabledInEnv(value) {
   if (value === void 0) return false;
   if (typeof value === "boolean") return value;
-  if (Array.isArray(value)) {
-    const env = nodeEnv || "development";
-    return value.includes(env);
-  }
+  if (Array.isArray(value)) return value.includes(nodeEnv || "development");
   return false;
 }
 async function findProjectRoot(startDir) {
@@ -121,6 +120,7 @@ class Sprint {
     };
     this.graphqlSchema = null;
     this.registeredRoutes = [];
+    this.fileMemoryUploadedLimit = 5 * 1024 * 1024;
     this.app = express();
     loadSprintConfig().then((config) => {
       const defaults = {
@@ -169,6 +169,7 @@ class Sprint {
           path: finalConfig.graphql?.graphiql?.path || "/graphiql"
         }
       };
+      this.fileMemoryUploadedLimit = finalConfig.fileMemoryUploadedLimit || 5 * 1024 * 1024;
       const openApiPath = this.openapi.path;
       const swaggerPath = this.openapi.swaggerUi.path;
       const graphqlPath = this.graphql.path;
@@ -194,6 +195,10 @@ class Sprint {
       this.loadDefaults();
       this.loadHealthcheck();
       this.routesLoaded = this.init();
+      this.memoryUpload = multer({
+        storage: multer.memoryStorage(),
+        limits: { fileSize: this.fileMemoryUploadedLimit }
+      });
       this.routesLoaded.then(async () => {
         if (this.openapi.generateOnBuild) {
           this.app.get(this.openapi.path, (_, res) => {
@@ -325,7 +330,7 @@ class Sprint {
     this.app.use(express.urlencoded({ limit: this.urlEncodedLimit, extended: false }));
   }
   /**
-   * Gets all matching middlewares for a given route path, sorted by priority
+   * Gets all matching middlewares for a given route path, sorted by priority.
    */
   getMiddlewaresForRoute(routePath) {
     const matched = [];
@@ -349,7 +354,7 @@ class Sprint {
     return matched.map((m) => m.handler);
   }
   /**
-   * Load all middleware files from the middlewares folder
+   * Load all middleware files from the middlewares folder.
    */
   async loadMiddlewares(middlewaresPath) {
     const fileExtensions = isProd ? [".mjs", ".js"] : [".ts"];
@@ -434,11 +439,37 @@ class Sprint {
                 }
               }
               const routeMiddlewares = this.getMiddlewaresForRoute(routePath);
+              let fileUploadMiddleware = null;
+              for (const layer of router.stack) {
+                if (!layer.route) continue;
+                for (const routeLayer of layer.route.stack) {
+                  const handler = routeLayer.handle;
+                  const handlerSchema = handler.__sprintRouteSchema;
+                  if (handlerSchema?.files && typeof handlerSchema.files === "object" && "field" in handlerSchema.files) {
+                    const fileConfig = handlerSchema.files;
+                    if (fileConfig.maxCount) {
+                      fileUploadMiddleware = this.uploadFiles(fileConfig.field);
+                    } else {
+                      fileUploadMiddleware = this.uploadFile(fileConfig.field);
+                    }
+                    break;
+                  }
+                }
+                if (fileUploadMiddleware) break;
+              }
               if (routeMiddlewares.length > 0) {
-                this.app.use(finalRoute, ...routeMiddlewares, router);
+                if (fileUploadMiddleware) {
+                  this.app.use(finalRoute, fileUploadMiddleware, ...routeMiddlewares, router);
+                } else {
+                  this.app.use(finalRoute, ...routeMiddlewares, router);
+                }
                 if (isVerbose) console.log(`[Sprint] Loaded route: ${finalRoute} -> ${filePath} (with ${routeMiddlewares.length} middleware(s))`);
               } else {
-                this.app.use(finalRoute, router);
+                if (fileUploadMiddleware) {
+                  this.app.use(finalRoute, fileUploadMiddleware, router);
+                } else {
+                  this.app.use(finalRoute, router);
+                }
                 if (isVerbose) console.log(`[Sprint] Loaded route: ${finalRoute} -> ${filePath}`);
               }
               this.counters.routes += router.stack.length;
@@ -803,6 +834,44 @@ class Sprint {
     tryListen(basePort);
     if (callback) callback();
   }
+  uploadFile(fieldName = "file") {
+    return this.memoryUpload.single(fieldName);
+  }
+  uploadFiles(fieldNames = "files") {
+    if (Array.isArray(fieldNames)) return this.memoryUpload.fields(fieldNames.map((name) => ({ name })));
+    return this.memoryUpload.array(fieldNames);
+  }
+  streamUpload(options) {
+    return (req, res) => {
+      return new Promise((resolve, reject) => {
+        const bb = busboy({
+          headers: req.headers,
+          limits: options?.limits
+        });
+        const files = [];
+        const fields = {};
+        bb.on("file", (fieldName, file, info) => {
+          files.push({
+            fieldName,
+            file,
+            filename: info.filename,
+            encoding: info.encoding,
+            mimeType: info.mimeType
+          });
+        });
+        bb.on("field", (fieldName, val) => {
+          fields[fieldName] = val;
+        });
+        bb.on("finish", () => {
+          resolve({ files, fields });
+        });
+        bb.on("error", (err) => {
+          reject(err);
+        });
+        req.pipe(bb);
+      });
+    };
+  }
 }
 function createSchemaValidationMiddleware(schema) {
   const headersSchema = schema.headers ? normalizeHeadersSchema(schema.headers) : null;

package/dist/esm/modules/schemas/index.js

@@ -1,4 +1,108 @@
 import { z } from "zod";
+function normalizeExtensions(ext) {
+  if (!ext) return [];
+  return (Array.isArray(ext) ? ext : [ext]).map((e) => e.toLowerCase().startsWith(".") ? e.toLowerCase() : `.${e.toLowerCase()}`);
+}
+function normalizeMimeTypes(mime) {
+  if (!mime) return [];
+  return (Array.isArray(mime) ? mime : [mime]).map((m) => m.toLowerCase());
+}
+function createFileSchema(options = {}) {
+  const extensions = normalizeExtensions(options.ext);
+  const mimeTypes = normalizeMimeTypes(options.mimeType);
+  const fileSchema = z.object({
+    fieldname: z.string(),
+    originalname: z.string(),
+    encoding: z.string(),
+    mimetype: z.string(),
+    size: z.number(),
+    buffer: z.instanceof(Buffer).optional()
+  });
+  return fileSchema.refine((file) => {
+    if (extensions.length === 0) return true;
+    const fileExt = file.originalname.toLowerCase().substring(file.originalname.lastIndexOf("."));
+    return extensions.includes(fileExt);
+  }, {
+    message: `Invalid file extension. Allowed: ${extensions.join(", ")}`,
+    path: ["originalname"]
+  }).refine((file) => {
+    if (mimeTypes.length === 0) return true;
+    return mimeTypes.includes(file.mimetype.toLowerCase());
+  }, {
+    message: `Invalid mime type. Allowed: ${mimeTypes.join(", ")}`,
+    path: ["mimetype"]
+  }).refine((file) => {
+    if (options.maxSize === void 0) return true;
+    return file.size <= options.maxSize;
+  }, {
+    message: `File size exceeds maximum of ${options.maxSize} bytes`,
+    path: ["size"]
+  }).refine((file) => {
+    if (options.minSize === void 0) return true;
+    return file.size >= options.minSize;
+  }, {
+    message: `File size must be at least ${options.minSize} bytes`,
+    path: ["size"]
+  });
+}
+function createFilesArraySchema(fieldName, options = {}) {
+  const fileSchema = createFileSchema({ ...options });
+  return z.array(fileSchema).min(options.required === false ? 0 : 1, {
+    message: options.required === false ? void 0 : `At least one file is required for field "${fieldName}"`
+  });
+}
+const fileValidators = {
+  ext: (ext) => {
+    const extensions = normalizeExtensions(ext);
+    return createFileSchema({ ext: extensions });
+  },
+  mimeType: (mimeType) => {
+    const mimeTypes = normalizeMimeTypes(mimeType);
+    return createFileSchema({ mimeType: mimeTypes });
+  },
+  maxSize: (maxSize) => {
+    return createFileSchema({ maxSize });
+  },
+  minSize: (minSize) => {
+    return createFileSchema({ minSize });
+  },
+  image: () => {
+    return createFileSchema({
+      mimeType: ["image/jpeg", "image/png", "image/gif", "image/webp", "image/svg+xml"],
+      ext: ["jpg", "jpeg", "png", "gif", "webp", "svg"]
+    });
+  },
+  document: () => {
+    return createFileSchema({
+      mimeType: ["application/pdf", "application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain"],
+      ext: ["pdf", "doc", "docx", "txt"]
+    });
+  },
+  video: () => {
+    return createFileSchema({
+      mimeType: ["video/mp4", "video/webm", "video/ogg"],
+      ext: ["mp4", "webm", "ogg"]
+    });
+  },
+  audio: () => {
+    return createFileSchema({
+      mimeType: ["audio/mpeg", "audio/wav", "audio/ogg", "audio/webm"],
+      ext: ["mp3", "wav", "ogg", "webm"]
+    });
+  },
+  archive: () => {
+    return createFileSchema({
+      mimeType: ["application/zip", "application/x-rar-compressed", "application/x-7z-compressed"],
+      ext: ["zip", "rar", "7z"]
+    });
+  },
+  any: () => {
+    return createFileSchema({});
+  },
+  field: (fieldName, options) => {
+    return createFilesArraySchema(fieldName, options);
+  }
+};
 function normalizeHeadersSchema(schema) {
   const shape = schema.shape ?? schema._def?.shape?.();
   if (!shape) return schema;
@@ -23,6 +127,7 @@ Object.assign(sprintCallable, sprintAuth);
 const proxyZ = new Proxy(z, {
   get(target, prop) {
     if (prop === "sprint") return sprintCallable;
+    if (prop === "files") return fileValidators;
     return target[prop];
   }
 });
@@ -41,6 +146,7 @@ function parseSchema(schema, data) {
 }
 function defineRouteSchema(schema) {
   const headersSchema = schema.headers ? normalizeHeadersSchema(schema.headers) : null;
+  const fileConfig = typeof schema.files === "object" && "field" in schema.files ? schema.files : null;
   const middleware = (req, res, next) => {
     const errors = [];
     const method = req.method.toUpperCase();
@@ -62,6 +168,24 @@ function defineRouteSchema(schema) {
       const result = headersSchema.safeParse(normalizedHeaders);
       if (!result.success) errors.push(...result.errors.map((e) => ({ location: "headers", ...e })));
     }
+    let filesData = [];
+    if (schema.files) {
+      if (fileConfig) {
+        const fieldFiles = req.file ? [req.file] : [];
+        const multiFiles = req.files?.[fileConfig.field] || [];
+        filesData = [...fieldFiles, ...Array.isArray(multiFiles) ? multiFiles : []];
+        if (fileConfig.maxCount && filesData.length > fileConfig.maxCount) errors.push({ location: "files", path: fileConfig.field, message: `Maximum ${fileConfig.maxCount} files allowed` });
+        if (fileConfig.schema && filesData.length > 0) {
+          const result = parseSchema(fileConfig.schema, filesData);
+          if (!result.success) errors.push(...result.errors.map((e) => ({ location: "files", ...e })));
+        }
+      } else {
+        const filesSchema = schema.files;
+        const reqFiles = req.files || (req.file ? [req.file] : []);
+        const result = parseSchema(filesSchema, reqFiles);
+        if (!result.success) errors.push(...result.errors.map((e) => ({ location: "files", ...e })));
+      }
+    }
     if (schema.sprint?.authorization) {
       const authSchema = schema.sprint.authorization;
       const description = authSchema._def?.description;
@@ -69,9 +193,7 @@ function defineRouteSchema(schema) {
       if (description) {
         try {
           const parsed = JSON.parse(description);
-          if (parsed.__sprintAuthorization && parsed.sources) {
-            sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
-          }
+          if (parsed.__sprintAuthorization && parsed.sources) sources = Array.isArray(parsed.sources) ? parsed.sources : [parsed.sources];
         } catch {
         }
       }
@@ -103,10 +225,19 @@ function defineRouteSchema(schema) {
     next();
   };
   middleware.__sprintRouteSchema = schema;
+  if (fileConfig) {
+    middleware.applyFileUpload = function(sprint) {
+      if (fileConfig.maxCount) return sprint.uploadFiles(fileConfig.field);
+      return sprint.uploadFile(fileConfig.field);
+    };
+  }
   return middleware;
 }
 export {
+  createFileSchema,
+  createFilesArraySchema,
   defineRouteSchema,
+  fileValidators as files,
   normalizeHeadersSchema,
   sprintBuilder as sprint,
   proxyZ as z

package/dist/types/modules/schemas/index.d.ts

@@ -1,9 +1,32 @@
 import { RequestHandler } from 'express';
 import { z, ZodSchema as ZodSchemaType, ZodTypeDef } from 'zod';
+import { FileObject } from './types';
 export type AuthorizationSource = `query:${string}` | `headers:${string}`;
 export interface SprintAuthorizationOptions {
     sources?: AuthorizationSource | AuthorizationSource[];
 }
+export interface FileValidationOptions {
+    ext?: string | string[];
+    mimeType?: string | string[];
+    maxSize?: number;
+    minSize?: number;
+    required?: boolean;
+}
+declare function createFileSchema(options?: FileValidationOptions): ZodSchemaType<FileObject, ZodTypeDef, FileObject>;
+declare function createFilesArraySchema(fieldName: string, options?: FileValidationOptions): ZodSchemaType<FileObject[], ZodTypeDef, FileObject[]>;
+declare const fileValidators: {
+    ext: (ext: string | string[]) => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    mimeType: (mimeType: string | string[]) => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    maxSize: (maxSize: number) => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    minSize: (minSize: number) => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    image: () => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    document: () => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    video: () => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    audio: () => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    archive: () => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    any: () => z.ZodType<FileObject, z.ZodTypeDef, FileObject>;
+    field: (fieldName: string, options?: FileValidationOptions) => z.ZodType<FileObject[], z.ZodTypeDef, FileObject[]>;
+};
 export declare function normalizeHeadersSchema(schema: any): any;
 declare function createSprintAuthorizationSchema(options?: SprintAuthorizationOptions): ZodSchemaType<string, ZodTypeDef, string>;
 declare const sprintBuilder: {
@@ -15,19 +38,29 @@ declare const sprintAuth: {
 type SprintCallable = typeof sprintAuth & (() => typeof sprintAuth);
 type ZodWithSprint = typeof z & {
     sprint: SprintCallable;
+    files: typeof fileValidators;
 };
 declare const proxyZ: ZodWithSprint;
 export { proxyZ as z };
 export { sprintBuilder as sprint };
+export { fileValidators as files };
+export { createFileSchema, createFilesArraySchema };
 export interface RouteSchemaOptions {
     body?: ZodSchemaType<any, ZodTypeDef, any>;
     queryParams?: ZodSchemaType<any, ZodTypeDef, any>;
     params?: ZodSchemaType<any, ZodTypeDef, any>;
     headers?: ZodSchemaType<any, ZodTypeDef, any>;
+    files?: ZodSchemaType<any, ZodTypeDef, any> | {
+        field: string;
+        maxCount?: number;
+        schema?: ZodSchemaType<any, ZodTypeDef, any>;
+    };
     sprint?: {
         authorization?: ZodSchemaType<string, ZodTypeDef, string>;
     };
 }
-export declare function defineRouteSchema<T extends RouteSchemaOptions>(schema: T): RequestHandler;
+export declare function defineRouteSchema<T extends RouteSchemaOptions>(schema: T): RequestHandler & {
+    applyFileUpload?: (sprint: any) => any;
+};
 export type { ZodSchema, ZodMiddlewareOptions } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/modules/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,SAAS,IAAI,aAAa,EAAE,UAAU,EAAuB,MAAM,KAAK,CAAC;AAErF,MAAM,MAAM,mBAAmB,GAAG,SAAS,MAAM,EAAE,GAAG,WAAW,MAAM,EAAE,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IACvC,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;CACzD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAKvD;AAED,iBAAS,+BAA+B,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAKxH;AAED,QAAA,MAAM,aAAa;;CAElB,CAAC;AAEF,QAAA,MAAM,UAAU;;CAEf,CAAC;AAEF,KAAK,cAAc,GAAG,OAAO,UAAU,GAAG,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAQpE,KAAK,aAAa,GAAG,OAAO,CAAC,GAAG;IAC5B,MAAM,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,QAAA,MAAM,MAAM,EAKN,aAAa,CAAC;AAEpB,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;AACvB,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC3C,WAAW,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE;QACL,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;KAC7D,CAAC;CACL;AAqBD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,EAAE,MAAM,EAAE,CAAC,GAAG,cAAc,CA8EzF;AAED,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/index.ts"],"names":[],"mappings":"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"}

package/dist/types/modules/schemas/types.d.ts

@@ -5,8 +5,24 @@ export interface ZodMiddlewareOptions {
     queryParams?: ZodSchema;
     params?: ZodSchema;
     headers?: ZodSchema;
+    files?: ZodSchema;
     sprint?: {
         authorization?: ZodSchema;
     };
 }
+export interface FileValidationOptions {
+    ext?: string | string[];
+    mimeType?: string | string[];
+    maxSize?: number;
+    minSize?: number;
+    required?: boolean;
+}
+export type FileObject = {
+    fieldname: string;
+    originalname: string;
+    encoding: string;
+    mimetype: string;
+    size: number;
+    buffer?: Buffer;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/types/modules/schemas/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE;QACL,aAAa,CAAC,EAAE,SAAS,CAAC;KAC7B,CAAC;CACL"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/schemas/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE;QACL,aAAa,CAAC,EAAE,SAAS,CAAC;KAC7B,CAAC;CACL;AAED,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAAG;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/types/sprint.d.ts

@@ -1,5 +1,5 @@
+import { default as express, Application, Request, Response } from 'express';
 import { Handler, MiddlewareConfig } from './types';
-import { default as express, Application } from 'express';
 export declare const isDevelopment: boolean;
 export declare const isProduction: boolean;
 export declare class Sprint {
@@ -19,15 +19,17 @@ export declare class Sprint {
     private graphql;
     private graphqlSchema;
     private registeredRoutes;
+    fileMemoryUploadedLimit: number;
+    memoryUpload: any;
     constructor();
     private init;
     private loadDefaults;
     /**
-     * Gets all matching middlewares for a given route path, sorted by priority
+     * Gets all matching middlewares for a given route path, sorted by priority.
      */
     private getMiddlewaresForRoute;
     /**
-     * Load all middleware files from the middlewares folder
+     * Load all middleware files from the middlewares folder.
      */
     private loadMiddlewares;
     private loadHealthcheck;
@@ -48,5 +50,23 @@ export declare class Sprint {
     use(pathOrHandler: string | Handler | MiddlewareConfig, maybeHandler?: Handler): express.Application;
     setGraphQLSchema(schema: any): void;
     listen(callback?: () => void): void;
+    uploadFile(fieldName?: string): any;
+    uploadFiles(fieldNames?: string | string[]): any;
+    streamUpload(options?: {
+        limits?: {
+            fileSize?: number;
+            files?: number;
+        };
+        headers?: Record<string, string>;
+    }): (req: Request, res: Response) => Promise<{
+        files: Array<{
+            fieldName: string;
+            file: NodeJS.ReadableStream;
+            filename: string;
+            encoding: string;
+            mimeType: string;
+        }>;
+        fields: Record<string, string>;
+    }>;
 }
 //# sourceMappingURL=sprint.d.ts.map

package/dist/types/sprint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprint.d.ts","sourceRoot":"","sources":["../../src/sprint.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAA+B,gBAAgB,EAAsC,MAAM,SAAS,CAAC;AACrH,OAAO,OAAO,EAAE,EAAE,WAAW,EAAoD,MAAM,SAAS,CAAC;AAejG,eAAO,MAAM,aAAa,SAAQ,CAAC;AACnC,eAAO,MAAM,YAAY,SAAS,CAAC;AA6CnC,qBAAa,MAAM;IACR,GAAG,EAAE,WAAW,CAAC;IACxB,OAAO,CAAC,IAAI,CAAwD;IACpE,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,OAAO,CAcT;IACN,OAAO,CAAC,OAAO,CAcT;IACN,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,gBAAgB,CAIhB;;YAuJM,IAAI;IAkDlB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAkC7B,OAAO,CAAC,eAAe;YAiBT,UAAU;YAmFV,YAAY;IAqB1B,OAAO,CAAC,YAAY;IAgCpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,mBAAmB;IA+K3B,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,CAAC,mBAAmB;IA+BpB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACpC,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,gBAAgB,EAAE,YAAY,CAAC,EAAE,OAAO;IAY9E,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAInC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;CA+D7C"}
+{"version":3,"file":"sprint.d.ts","sourceRoot":"","sources":["../../src/sprint.ts"],"names":[],"mappings":"AAYA,OAAO,OAAO,EAAE,EAAE,WAAW,EAA2C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC3G,OAAO,EAAE,OAAO,EAA+B,gBAAgB,EAAsC,MAAM,SAAS,CAAC;AAcrH,eAAO,MAAM,aAAa,SAAQ,CAAC;AACnC,eAAO,MAAM,YAAY,SAAS,CAAC;AA0CnC,qBAAa,MAAM;IACR,GAAG,EAAE,WAAW,CAAC;IACxB,OAAO,CAAC,IAAI,CAAwD;IACpE,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,OAAO,CAcT;IACN,OAAO,CAAC,OAAO,CAcT;IACN,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,gBAAgB,CAIhB;IACD,uBAAuB,EAAE,MAAM,CAAmB;IAClD,YAAY,EAAE,GAAG,CAAC;;YA6JX,IAAI;IAkDlB,OAAO,CAAC,YAAY;IAiDpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;YACW,eAAe;IAkC7B,OAAO,CAAC,eAAe;YAeT,UAAU;YA+GV,YAAY;IAqB1B,OAAO,CAAC,YAAY;IAgCpB,+BAA+B;IAC/B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,mBAAmB;IA+K3B,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,CAAC,mBAAmB;IA+BpB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IACpC,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,gBAAgB,EAAE,YAAY,CAAC,EAAE,OAAO;IAY9E,gBAAgB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAInC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAgEnC,UAAU,CAAC,SAAS,GAAE,MAAe;IAIrC,WAAW,CAAC,UAAU,GAAE,MAAM,GAAG,MAAM,EAAY;IAKnD,YAAY,CAAC,OAAO,CAAC,EAAE;QAC1B,MAAM,CAAC,EAAE;YACL,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,KAAK,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;QACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,IACW,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,OAAO,CAAC;QAC1C,KAAK,EAAE,KAAK,CAAC;YACT,SAAS,EAAE,MAAM,CAAC;YAClB,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC;YAC5B,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;QACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,CAAC;CA0CT"}

package/dist/types/types.d.ts

@@ -106,6 +106,8 @@ export interface SprintOptions {
             path?: string;
         };
     };
+    /** Maximum file size (in bytes) for memory storage uploads. Default: 5MB (5 * 1024 * 1024) */
+    fileMemoryUploadedLimit?: number;
 }
 export interface SprintConfig {
     port?: string | number | null;
@@ -133,6 +135,8 @@ export interface SprintConfig {
             path?: string;
         };
     };
+    /** Maximum file size (in bytes) for memory storage uploads. Default: 5MB (5 * 1024 * 1024) */
+    fileMemoryUploadedLimit?: number;
 }
 export type { NextFunction } from 'express';
 //# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,SAAiC,CAAC;AACpD,eAAO,MAAM,SAAS,SAAqC,CAAC;AAE5D,QAAA,IAAI,UAAU,EAAE,MAAM,CAAC;AACvB,QAAA,IAAI,SAAS,EAAE,MAAM,CAAC;AAYtB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAoBxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAS7D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,SAAiC,CAAC;AACpD,eAAO,MAAM,SAAS,SAAqC,CAAC;AAE5D,QAAA,IAAI,UAAU,EAAE,MAAM,CAAC;AACvB,QAAA,IAAI,SAAS,EAAE,MAAM,CAAC;AAYtB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAgBxE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAS7D"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sprint-es",
-    "version": "0.0.156",
+    "version": "0.0.157",
     "description": "Sprint - Quickly API",
     "main": "dist/cjs/index.js",
     "module": "dist/esm/index.js",
@@ -109,6 +109,7 @@
     "dependencies": {
         "@types/express": "^5.0.5",
         "axios": "^1.13.2",
+        "busboy": "^1.6.0",
         "cors": "^2.8.5",
         "dotenv": "^17.3.1",
         "express": "^5.1.0",
@@ -125,6 +126,7 @@
         "FJRG2007 (https://github.com/FJRG2007)"
     ],
     "devDependencies": {
+        "@types/busboy": "^1.5.4",
         "@types/cors": "^2.8.19",
         "@types/jest": "^30.0.0",
         "@types/morgan": "^1.9.10",