uplix

MediaManager.js

A Node.js media management utility & media handling.
Supports single & multiple file uploads, any file type, image resizing & conversion, and controller-level usage (no middleware needed).
get usage in example folder
---

📦 Installation

```bash
npm install uplix

# Usage direct in controller
const { MediaManager } = require('uplix');

const media = new MediaManager(
'uploads',
'/uploads',
{ maxFileSizeMB: 10 },
{ convertToWebP: true } # false for original extension
);

# Create fields and files

# Parse fields and files automatically
const payload = await media.auto(req);
# Handle image upload
let imageFileName = null;
if (payload.image) {
const fileData = Array.isArray(payload.image) ? payload.image[0] : payload.image;
imageFileName = fileData.fileName;
}

# Create new model
const model = await Model.create({
name: payload.name,
image: imageFileName,
is_active: payload.is_active ?? false, # boolean parsed by auto()
});


# Update fields and files

const model = await Model.find(req.params.id);
# Auto-parse fields and files
const data = await media.auto(req);
# Fill other fields
model.fill({
name: data.name,
is_active: model.is_active ?? false, # already boolean from auto()
});
# Handle image upload
if (data.image) {
# Normalize: payload.image may be an array if multiple files uploaded
const fileData = Array.isArray(data.image) ? data.image[0] : data.image;
# Remove old file if it exists
if (model.image) {
await media.remove(model.image, 'image');
}
# Update with new file
model.image = fileData.fileName;
}
await model.save();

# Delet files
if (model.image) {
await media.remove(model.image, 'image');
}


# SECOND METHOD

# Create file
let image;
image = await media.file(req, 'image', {
resize: true,
width: 1920,
height: 1080,
format: 'webp',
quality: 80
});
await Model.create({
image: image.fileName
});


# Update file
const { files } = await media.parseRequest(req);
const model = await Model.find(req.params.id);
let imageName = model.image;
# ✅ DYNAMIC: works for single or multiple
if (media.hasFile(files, 'image')) {
const imageFile = media.getFirstFile(files, 'image');
const image = await media.processFile(imageFile, 'image', {
resize: true,
width: 1920,
height: 1080,
format: 'webp',
quality: 80
});
# Remove old image safely
if (model.image) {
await media.remove(model.image, 'image');
}
imageName = image.fileName;
}
await model.update({
image: imageName
});


# Controller Example Usage With Different File Types
const media = new MediaManager('./uploads/files', '/uploads/files');

# Upload a PDF
const pdfFile = await media.file(req, 'document');

# Upload multiple videos
const videos = await media.files(req, 'videos');

# Upload an MP3
const song = await media.file(req, 'song');

#Uploads one required file.
const avatar = await media.file(req, 'avatar');


#BONUS: MULTIPLE FILES (Gallery Example)
const gallery = await media.files(req, 'gallery');


# Automatically decides single vs multiple
const data = await media.auto(req);
# Example form





const uploaded = await Promise.all(
galleryFiles
.filter(f => f.size > 0)
.map(f => media.processFile(f, 'gallery'))
);
# Supported image formats
jpg, jpeg, png, webp, tiff, gif

# Enable WebP conversion
new MediaManager('uploads', '/uploads', {}, {
convertToWebP: true
});

# Returned metadata
{
id: "e8c7a...",
field: "avatar",
fileName: "1699-abc.webp",
mime: "image/webp",
sizeMB: 0.43,
path: "/uploads/avatar/1699-abc.webp",
url: "/uploads/avatar/1699-abc.webp",
createdAt: Date
}