NodeImageStorage

node-image-storage is an easy-to-use Node.js module for managing image uploads, deletions, and updates via an external API.

Description of node-image-storage Package

Purpose

The node-image-storage package is designed for convenient management of images by providing functionality for uploading, deleting, and updating files through an external API. It simplifies the process of integrating image handling capabilities into your Node.js application.

Features

Image Upload:

Checks file type before uploading. Converts all images to webp format (except SVG, which are kept in their original format). Assigns unique names to all uploaded files. Uploads files to an external server using an API key for authentication.

Get Images:

Retrieves images by their names.

Delete Images:

Deletes files from the external server using an API key.

Update Images:

Updates existing image files by deleting the old file and uploading a new one.

Example Usage

1const ImageStorage = require('node-image-storage');
2
3// Initialize with API parameters
4ImageStorage.option({
5  api_url: 'https://your-api-url.com/uploads',
6  api_key: 'your-api-key'
7});
8
9// Upload an image
10ImageStorage.uploadImage(file).then(response => {
11  console.log(response);
12});
13
14// Delete an image
15ImageStorage.deleteImage('image-name.webp').then(response => {
16  console.log(response);
17});
18
19// Update an image
20ImageStorage.updateImage({
21  update_fileName: 'old-image-name.webp',
22  file: newFile
23}).then(response => {
24  console.log(response);
25});

Setting Up the Image Storage Server

1. Clone the repository

   1git clone https://github.com/Subm1s/image-storage-server

2. Install dependencies

   1npm install

3. Create a .env file in the root of the project and add the following environment variables:

   1PORT=5000
   2API_KEY=your-api-key

4. Run the server:

   1npm start

   The server will start on the specified port (e.g., http://localhost:5000).

Installation

Install the NodeImageStorage package using npm:

1npm install node-image-storage

Usage

1const ImageStorage = require('node-image-storage')

Before using the module, configure it with your API_URL and API_KEY

1ImageStorage.option({
2  api_url: 'http://localhost:5000/uploads',
3  api_key: 'your-api-key',
4})

api_url and api_key must be a string

Uploading an Image

1async ImageStorage.uploadImage(file)

The file must be an OBJECT.

Return data:

1return { success, image_name, message };

success = Boolean image_name = String
message = String

Deleting an Image

1async ImageStorage.deleteImage(fileName)

The fileName must be an STRING.

Return data:

1return { success, message };

success = Boolean message = String

Updating an Image

1const updateDetails = {
2    update_fileName: fileName,
3    file: file,
4}
5
6async ImageStorage.updateImage(updateDetails)

The fileName must be an STRING. The file must be an OBJECT.

Return data:

1return { success, image_name, message };

success = Boolean image_name = String
message = String