smart-multer-utils 0.0.1

package/dist/cjs/asyncHandler.js

@@ -0,0 +1 @@
+export const asyncHandler = (fn) => (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);

package/dist/cjs/cleanup.js

@@ -0,0 +1,11 @@
+import fs from "fs";
+export function cleanupFile(file) {
+    if ((file === null || file === void 0 ? void 0 : file.path) && fs.existsSync(file.path)) {
+        fs.unlinkSync(file.path);
+    }
+}
+export function cleanupFiles(files) {
+    if (!files)
+        return;
+    files.forEach(cleanupFile);
+}

package/dist/cjs/compress.js

@@ -0,0 +1,11 @@
+import sharp from "sharp";
+import fs from "fs";
+import path from "path";
+export async function compressImage(file, quality = 80) {
+    const ext = path.extname(file.filename);
+    const compressed = file.path.replace(ext, `-compressed${ext}`);
+    await sharp(file.path).jpeg({ quality }).png({ quality }).toFile(compressed);
+    fs.unlinkSync(file.path);
+    file.path = compressed;
+    file.filename = path.basename(compressed);
+}

package/dist/cjs/helpers.js

@@ -0,0 +1,33 @@
+import fs from "fs";
+import path from "path";
+import { getExtension } from "./validators.js";
+export function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+export function resolveUploadPath(file, folder) {
+    var _a, _b;
+    const ext = getExtension(file);
+    const base = (_a = folder === null || folder === void 0 ? void 0 : folder.basePath) !== null && _a !== void 0 ? _a : "uploads";
+    let finalPath = base;
+    if ((folder === null || folder === void 0 ? void 0 : folder.byCategory) && folder.extensionMap) {
+        finalPath = path.join(base, (_b = folder.extensionMap[ext]) !== null && _b !== void 0 ? _b : "others");
+    }
+    if (folder === null || folder === void 0 ? void 0 : folder.byExtension) {
+        finalPath = path.join(finalPath, ext);
+    }
+    if ((folder === null || folder === void 0 ? void 0 : folder.autoCreate) !== false) {
+        ensureDir(finalPath);
+    }
+    return finalPath;
+}
+export function resolveFileSizeLimit(file, sizeConfig) {
+    var _a, _b, _c, _d;
+    if (!(sizeConfig === null || sizeConfig === void 0 ? void 0 : sizeConfig.enabled)) {
+        return ((_a = sizeConfig === null || sizeConfig === void 0 ? void 0 : sizeConfig.defaultMB) !== null && _a !== void 0 ? _a : 5) * 1024 * 1024;
+    }
+    const ext = getExtension(file);
+    const limit = (_d = (_c = (_b = sizeConfig.perExtensionMB) === null || _b === void 0 ? void 0 : _b[ext]) !== null && _c !== void 0 ? _c : sizeConfig.defaultMB) !== null && _d !== void 0 ? _d : 5;
+    return limit * 1024 * 1024;
+}

package/dist/cjs/index.js

@@ -0,0 +1,4 @@
+export * from "./uploader.js";
+export * from "./asyncHandler.js";
+export * from "./cleanup.js";
+export * from "./types.js";

package/dist/cjs/types.js

@@ -0,0 +1 @@
+export {};

package/dist/cjs/uploader.js

@@ -0,0 +1,65 @@
+import multer from "multer";
+import { validateExtension } from "./validators.js";
+import { resolveUploadPath, resolveFileSizeLimit } from "./helpers.js";
+import { cleanupFile, cleanupFiles } from "./cleanup.js";
+import { compressImage } from "./compress.js";
+export function createUploader(config) {
+    const { fieldName, allowedExtensions, sizeConfig, filename, multiple = false, maxFiles = 5, folderConfig, cleanupOnError = true, compressImage: shouldCompress = false, imageQuality = 80, } = config;
+    const storage = multer.diskStorage({
+        destination: (req, file, cb) => {
+            cb(null, resolveUploadPath(file, folderConfig));
+        },
+        filename: (req, file, cb) => {
+            var _a;
+            const name = (_a = filename === null || filename === void 0 ? void 0 : filename(req, file)) !== null && _a !== void 0 ? _a : `${Date.now()}-${file.originalname}`;
+            cb(null, name);
+        },
+    });
+    const upload = multer({
+        storage,
+        fileFilter: (req, file, cb) => {
+            if (!validateExtension(file, allowedExtensions)) {
+                return cb(new Error("File extension not allowed"));
+            }
+            cb(null, true);
+        },
+        limits: {
+            fileSize: (sizeConfig === null || sizeConfig === void 0 ? void 0 : sizeConfig.defaultMB)
+                ? sizeConfig.defaultMB * 1024 * 1024
+                : undefined,
+        },
+    });
+    const wrap = (middleware) => async (req, res, next) => {
+        middleware(req, res, async (err) => {
+            if (err) {
+                if (cleanupOnError) {
+                    cleanupFile(req.file);
+                    cleanupFiles(req.files);
+                }
+                return next(err);
+            }
+            try {
+                const files = req.file ? [req.file] : req.files || [];
+                for (const file of files) {
+                    const maxSize = resolveFileSizeLimit(file, sizeConfig);
+                    if (file.size > maxSize) {
+                        throw new Error(`File ${file.originalname} exceeds size limit`);
+                    }
+                    if (shouldCompress) {
+                        await compressImage(file, imageQuality);
+                    }
+                }
+                next();
+            }
+            catch (e) {
+                cleanupFile(req.file);
+                cleanupFiles(req.files);
+                next(e);
+            }
+        });
+    };
+    return {
+        single: () => wrap(upload.single(fieldName)),
+        multiple: () => wrap(upload.array(fieldName, maxFiles)),
+    };
+}

package/dist/cjs/validators.js

@@ -0,0 +1,9 @@
+import path from "path";
+export function getExtension(file) {
+    return path.extname(file.originalname).replace(".", "").toLowerCase();
+}
+export function validateExtension(file, allowed) {
+    if (!allowed || allowed.length === 0)
+        return true;
+    return allowed.includes(getExtension(file));
+}

package/dist/esm/asyncHandler.js

@@ -0,0 +1 @@
+export const asyncHandler = (fn) => (req, res, next) => Promise.resolve(fn(req, res, next)).catch(next);

package/dist/esm/cleanup.js

@@ -0,0 +1,11 @@
+import fs from "fs";
+export function cleanupFile(file) {
+    if ((file === null || file === void 0 ? void 0 : file.path) && fs.existsSync(file.path)) {
+        fs.unlinkSync(file.path);
+    }
+}
+export function cleanupFiles(files) {
+    if (!files)
+        return;
+    files.forEach(cleanupFile);
+}

package/dist/esm/compress.js

@@ -0,0 +1,11 @@
+import sharp from "sharp";
+import fs from "fs";
+import path from "path";
+export async function compressImage(file, quality = 80) {
+    const ext = path.extname(file.filename);
+    const compressed = file.path.replace(ext, `-compressed${ext}`);
+    await sharp(file.path).jpeg({ quality }).png({ quality }).toFile(compressed);
+    fs.unlinkSync(file.path);
+    file.path = compressed;
+    file.filename = path.basename(compressed);
+}

package/dist/esm/helpers.js

@@ -0,0 +1,33 @@
+import fs from "fs";
+import path from "path";
+import { getExtension } from "./validators.js";
+export function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+export function resolveUploadPath(file, folder) {
+    var _a, _b;
+    const ext = getExtension(file);
+    const base = (_a = folder === null || folder === void 0 ? void 0 : folder.basePath) !== null && _a !== void 0 ? _a : "uploads";
+    let finalPath = base;
+    if ((folder === null || folder === void 0 ? void 0 : folder.byCategory) && folder.extensionMap) {
+        finalPath = path.join(base, (_b = folder.extensionMap[ext]) !== null && _b !== void 0 ? _b : "others");
+    }
+    if (folder === null || folder === void 0 ? void 0 : folder.byExtension) {
+        finalPath = path.join(finalPath, ext);
+    }
+    if ((folder === null || folder === void 0 ? void 0 : folder.autoCreate) !== false) {
+        ensureDir(finalPath);
+    }
+    return finalPath;
+}
+export function resolveFileSizeLimit(file, sizeConfig) {
+    var _a, _b, _c, _d;
+    if (!(sizeConfig === null || sizeConfig === void 0 ? void 0 : sizeConfig.enabled)) {
+        return ((_a = sizeConfig === null || sizeConfig === void 0 ? void 0 : sizeConfig.defaultMB) !== null && _a !== void 0 ? _a : 5) * 1024 * 1024;
+    }
+    const ext = getExtension(file);
+    const limit = (_d = (_c = (_b = sizeConfig.perExtensionMB) === null || _b === void 0 ? void 0 : _b[ext]) !== null && _c !== void 0 ? _c : sizeConfig.defaultMB) !== null && _d !== void 0 ? _d : 5;
+    return limit * 1024 * 1024;
+}

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export * from "./uploader.js";
+export * from "./asyncHandler.js";
+export * from "./cleanup.js";
+export * from "./types.js";

package/dist/esm/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/uploader.js

@@ -0,0 +1,65 @@
+import multer from "multer";
+import { validateExtension } from "./validators.js";
+import { resolveUploadPath, resolveFileSizeLimit } from "./helpers.js";
+import { cleanupFile, cleanupFiles } from "./cleanup.js";
+import { compressImage } from "./compress.js";
+export function createUploader(config) {
+    const { fieldName, allowedExtensions, sizeConfig, filename, multiple = false, maxFiles = 5, folderConfig, cleanupOnError = true, compressImage: shouldCompress = false, imageQuality = 80, } = config;
+    const storage = multer.diskStorage({
+        destination: (req, file, cb) => {
+            cb(null, resolveUploadPath(file, folderConfig));
+        },
+        filename: (req, file, cb) => {
+            var _a;
+            const name = (_a = filename === null || filename === void 0 ? void 0 : filename(req, file)) !== null && _a !== void 0 ? _a : `${Date.now()}-${file.originalname}`;
+            cb(null, name);
+        },
+    });
+    const upload = multer({
+        storage,
+        fileFilter: (req, file, cb) => {
+            if (!validateExtension(file, allowedExtensions)) {
+                return cb(new Error("File extension not allowed"));
+            }
+            cb(null, true);
+        },
+        limits: {
+            fileSize: (sizeConfig === null || sizeConfig === void 0 ? void 0 : sizeConfig.defaultMB)
+                ? sizeConfig.defaultMB * 1024 * 1024
+                : undefined,
+        },
+    });
+    const wrap = (middleware) => async (req, res, next) => {
+        middleware(req, res, async (err) => {
+            if (err) {
+                if (cleanupOnError) {
+                    cleanupFile(req.file);
+                    cleanupFiles(req.files);
+                }
+                return next(err);
+            }
+            try {
+                const files = req.file ? [req.file] : req.files || [];
+                for (const file of files) {
+                    const maxSize = resolveFileSizeLimit(file, sizeConfig);
+                    if (file.size > maxSize) {
+                        throw new Error(`File ${file.originalname} exceeds size limit`);
+                    }
+                    if (shouldCompress) {
+                        await compressImage(file, imageQuality);
+                    }
+                }
+                next();
+            }
+            catch (e) {
+                cleanupFile(req.file);
+                cleanupFiles(req.files);
+                next(e);
+            }
+        });
+    };
+    return {
+        single: () => wrap(upload.single(fieldName)),
+        multiple: () => wrap(upload.array(fieldName, maxFiles)),
+    };
+}

package/dist/esm/validators.js

@@ -0,0 +1,9 @@
+import path from "path";
+export function getExtension(file) {
+    return path.extname(file.originalname).replace(".", "").toLowerCase();
+}
+export function validateExtension(file, allowed) {
+    if (!allowed || allowed.length === 0)
+        return true;
+    return allowed.includes(getExtension(file));
+}

package/dist/types/asyncHandler.d.ts

@@ -0,0 +1,2 @@
+import { Request, Response, NextFunction } from "express";
+export declare const asyncHandler: (fn: Function) => (req: Request, res: Response, next: NextFunction) => Promise<any>;

package/dist/types/cleanup.d.ts

@@ -0,0 +1,2 @@
+export declare function cleanupFile(file?: Express.Multer.File): void;
+export declare function cleanupFiles(files?: Express.Multer.File[]): void;

package/dist/types/compress.d.ts

@@ -0,0 +1 @@
+export declare function compressImage(file: Express.Multer.File, quality?: number): Promise<void>;

package/dist/types/helpers.d.ts

@@ -0,0 +1,4 @@
+import { FolderConfig, SizeConfig } from "./types.js";
+export declare function ensureDir(dir: string): void;
+export declare function resolveUploadPath(file: Express.Multer.File, folder?: FolderConfig): string;
+export declare function resolveFileSizeLimit(file: Express.Multer.File, sizeConfig?: SizeConfig): number;

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./uploader.js";
+export * from "./asyncHandler.js";
+export * from "./cleanup.js";
+export * from "./types.js";

package/dist/types/types.d.ts

@@ -0,0 +1,25 @@
+import { Request } from "express";
+export interface FolderConfig {
+    basePath?: string;
+    autoCreate?: boolean;
+    byExtension?: boolean;
+    byCategory?: boolean;
+    extensionMap?: Record<string, string>;
+}
+export interface SizeConfig {
+    enabled?: boolean;
+    defaultMB?: number;
+    perExtensionMB?: Record<string, number>;
+}
+export interface UploadConfig {
+    fieldName: string;
+    allowedExtensions?: string[];
+    sizeConfig?: SizeConfig;
+    filename?: (req: Request, file: Express.Multer.File) => string;
+    multiple?: boolean;
+    maxFiles?: number;
+    folderConfig?: FolderConfig;
+    cleanupOnError?: boolean;
+    compressImage?: boolean;
+    imageQuality?: number;
+}

package/dist/types/uploader.d.ts

@@ -0,0 +1,5 @@
+import { UploadConfig } from "./types.js";
+export declare function createUploader(config: UploadConfig): {
+    single: () => (req: any, res: any, next: any) => Promise<void>;
+    multiple: () => (req: any, res: any, next: any) => Promise<void>;
+};

package/dist/types/validators.d.ts

@@ -0,0 +1,2 @@
+export declare function getExtension(file: Express.Multer.File): string;
+export declare function validateExtension(file: Express.Multer.File, allowed?: string[]): boolean;

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "smart-multer-utils",
+  "version": "0.0.1",
+  "description": "Config-driven Multer utility for easy file uploads with extension-based validation, auto folder management, size limits, cleanup, and optional image compression",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "license": "MIT",
+  "author": {
+    "name": "Manan Patel",
+    "email": "mananpatel1603@gmail.com",
+    "url": "https://github.com/mananzealousweb"
+  },
+  "maintainers": [
+    {
+      "name": "Manan Patel",
+      "email": "mananpatel1603@gmail.com"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mananzealousweb/RealTMS-Backend.git"
+  },
+  "scripts": {
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build": "npm run build:esm && npm run build:cjs"
+  },
+  "dependencies": {
+    "express": "^5.2.1",
+    "multer": "^2.0.2",
+    "sharp": "^0.34.5"
+  },
+  "keywords": [
+    "multer",
+    "file-upload",
+    "express",
+    "upload-middleware",
+    "file-validation",
+    "image-upload",
+    "compression",
+    "nodejs",
+    "internal",
+    "utility"
+  ],
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^25.0.3"
+  }
+}