multer-sharp

Multer-Sharp

---

Multer Sharp is streaming multer storage engine permit to resize and upload to Google Cloud Storage.

This project is mostly an integration piece for existing code samples from Multer's storage engine documentation. With add-ons include google-cloud and sharp

Requirement:

node v6 LTS version or latest version

Installation

npm:

npm install --save multer-sharp

yarn:

yarn add multer-sharp

Tests

npm test

Usage

const express = require('express');
const multer = require('multer');
const gcsSharp = require('multer-sharp');

const app = express();

// without resize image
const storage = gcsSharp({
    bucket: 'YOUR_BUCKET', // Required : bucket name to upload
    projectId: 'YOUR_PROJECTID', // Required : Google project ID
    keyFilename: 'YOUR_KEYFILENAME', // Required : JSON credentials file for Google Cloud Storage
    destination: 'public/image', // Optional : destination folder to store your file on Google Cloud Storage, default: ''
    acl: 'publicRead' // Required : acl credentials file for Google Cloud Storage, 'publicrRead' or 'private', default: 'private'
});
const upload = multer({ storage });

app.post('/upload', upload.single('myPic'), (req, res) => {
    console.log(req.file); // Print upload details
    res.send('Successfully uploaded!');
});

// or

// simple resize with custom filename
const storage2 = gcsSharp({
  filename: (req, file, cb) => {
      cb(null, `${file.fieldname}-newFilename`);
  },
  bucket: 'YOUR_BUCKET', // Required : bucket name to upload
  projectId: 'YOUR_PROJECTID', // Required : Google project ID
  keyFilename: 'YOUR_KEYFILENAME', // Required : JSON credentials file for Google Cloud Storage
  acl: 'publicRead', // Required : acl credentials file for Google Cloud Storage, 'publicrRead' or 'private', default: 'private'
  size: {
    width: 400,
    height: 400
  },
  max: true
});
const upload2 = multer({ storage: storage2 });

app.post('/uploadwithfilename', upload2.single('myPic'), (req, res, next) => {
    console.log(req.file); // Print upload details
    res.send('Successfully uploaded!');
});

for more example you can see here

Options

const storage = gcsSharp(options);

Multer-Sharp options

option	default	role
filename	randomString	your output filename
bucket	no	Required your bucket name on Google Cloud Storage to upload
projectId	no	Required your project id on Google Cloud Storage to upload
keyFilename	no	Required JSON credentials file for Google Cloud Storage
acl	'private'	Required acl credentials file for Google Cloud Storage, value: publicRead or private, doc: https://cloud.google.com/storage/docs/access-control/lists
destination	emptyString	Optional, destination folder to store your file on Google Cloud Storage
format	originalFileFormat	type of output file to produce. valid value : 'jpeg', 'png', 'magick', 'webp', 'tiff', 'openslide', 'dz', 'ppm', 'fits', 'gif', 'svg', 'pdf', 'v', 'raw' or object. if object specify as follow: { type: 'png', option: { [...toFormatOptions] } } doc: sharpToFormat
size	no	size specification object for output image, as follow: { width: 300, height: 200, option: {[...resizeOptions]} } property height & option is optional. doc: sharpResizeOptions

sharp options

Please visit this sharp for detailed overview of specific option.

multer-sharp embraces sharp option, as table below:

option	default	role
resize	true	resize images as per their size mentioned in options.size
crop	false	crop image
background	false	set the background for the embed, flatten and extend operations.
embed	false	embed on canvas
max	false	set maximum output dimension
min	false	set minimum output dimension
withoutEnlargement	false	do not enlarge small images
ignoreAspectRatio	false	ignore aspect ration while resizing images
extract	false	extract specific part of image
trim	false	Trim boring pixels from all edges
flatten	false	Merge alpha transparency channel, if any, with background.
extend	false	Extends/pads the edges of the image with background.
negate	false	Produces the negative of the image.
rotate	false	Rotate the output image by either an explicit angle
flip	false	Flip the image about the vertical Y axis.
flop	false	Flop the image about the horizontal X axis.
blur	false	Mild blur of the output image
sharpen	false	Mild sharpen of the output image
gamma	false	Apply a gamma correction.
grayscale or greyscale	false	Convert to 8-bit greyscale; 256 shades of grey.
normalize or normalise	false	Enhance output image contrast by stretching its luminance to cover the full dynamic range.
withMetadata	false	Include all metadata (EXIF, XMP, IPTC) from the input image in the output image.
convolve	false	Convolve the image with the specified kernel.
threshold	false	Any pixel value greather than or equal to the threshold value will be set to 255, otherwise it will be set to 0
toColourspace or toColorspace	false	Set the output colourspace. By default output image will be web-friendly sRGB, with additional channels interpreted as alpha channels.

---

License

MIT Copyright (c) 2017 - forever Abdul Fattah Ikhsan