Simple Digital Ocean Spaces Client

Usage

Credentials setup

You can set the environment variables AWS_ACCESS_KEY_ID and AWS_SECRET_KEY as default credentials for the S3 SDK which is also used by Digital Ocean Spaces API.

Create client for Digital Ocean Spaces API

import SpacesClient from 'simples-do-spaces';

const client = new SpacesClient(
  'sfo2.digitaloceanspaces.com', // Required, Digital Ocean Spaces Endpoint
  'bucketName', // Required. Bucket name
  'accessKeyId', // Optional. Access key, can be provided via env var AWS_ACCESS_KEY_ID
  'secretAccessKey' // Optional. Access key secret, can be env var AWS_SECRET_ACCESS_KEY
);

All methods returns a Promise which resolves to the values described below.

Upload file

client.uploadFile(uploadFilePath, destinationPath, permission);

• uploadFilePath : File path in file system
• destinationPath : Path to save in DO Spaces
• permission : Permission of the file, default is private, can also be public-red.

Return file URL in DO Spaces CDN

List files

client.listPathFiles(path);

• path : Path in DO Spaces to list

Return array with URL of files

Delete one file

client.deleteFile(path);

• path : Relative path to one file in DO spaces to delete it

Delete multiple files

client.deletePaths(paths);

• paths : Array of relative paths in DO spaces to delete

Download file

client.downloadFile(filePathToRead, filePathToSave, createDirIfNotExists);

• filePathToRead : Path in DO Spaces
• filePathToSave : Path to save in file system
• createDirIfNotExists : Boolean to create the folder if the it doesn't exists. Default is true

License

MIT © Bruno Orlandi