Socket
Socket
Sign inDemoInstall

solid-bucket

Package Overview
Dependencies
280
Maintainers
1
Versions
19
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    solid-bucket

A universal API for Cloud Storage providers


Version published
Maintainers
1
Created

Readme

Source

Solid Bucket

A universal API for Cloud Storage providers

Supported Providers:

  • Amazon AWS S3
  • Backblaze B2
  • Google Cloud Storage
  • Microsoft Azure Blob Storage
  • DigitalOcean Spaces
  • Rackspace Cloud Storage
  • Wasabi Object Storage
  • Any S3 Compatible Storage (e.g Minio)
  • Local Folder (e.g Dropbox, NAS...)

1. How to install it

npm install solid-bucket

2. How to Authenticate

2.1 Amazon AWS S3

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('aws', {
    accessKeyId: 'accessKeyId',
    secretAccessKey: 'secretAccessKey',
    region: 'us-east-1' // Optional: "us-east-1" by default
})

2.2 Backblaze B2

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('b2', {
    accountId: 'accountId',
    applicationKey: 'applicationKey'
})

2.3 Google Cloud Storage

const SolidBucket = require('solid-bucket')

// How to generate a credentials JSON file: https://cloud.google.com/storage/docs/authentication (To generate a private key in JSON format)
let provider = new SolidBucket('gcs', {
    keyFilename: 'keyFilename'
})

2.4 Microsoft Azure Blob Storage

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('azure', {
    accountName: 'accountName',
    accountKey: 'accountKey'
})

2.5 DigitalOcean Spaces

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('digitalocean', {
    accessKeyId: 'accessKeyId',
    secretAccessKey: 'secretAccessKey',
    region: 'nyc3' // Optional: "nyc3" by default
})

2.6 Rackspace Cloud Storage

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('rackspace', {
    username: 'username',
    apiKey: 'apiKey',
    region: 'IAD' // Optional: 'IAD' by default
})

2.7 Wasabi Object Storage

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('wasabi', {
    accessKeyId: 'accessKeyId',
    secretAccessKey: 'secretAccessKey',
})

2.8 Any S3 Compatible Storage (e.g Minio)

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('s3compatible', {
    endpoint: 'endpoint',
    accessKeyId: 'accessKeyId',
    secretAccessKey: 'secretAccessKey',
})

2.9 Local Folder (e.g Dropbox, NAS...)

const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('folder', {
    folderPath: 'folderPath'
})

3. Universal API

3.1 Create a Bucket

3.1.1 Definition
provider.createBucket(bucketName) // returns a Promise
3.1.2 Full Example
const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('azure', {
    accountName: 'accountName',
    accountKey: 'accountKey'
})

let bucketName = 'example'
provider.createBucket(bucketName).then((resp) => {
    if (resp.status === 201) {
        console.log(resp.message) 
        // Output: Bucket "example" was created successfully
    }
}).catch((resp) => {
    if (resp.status === 400){
        console.log(resp.message)
        // Output: Some error coming from the provider...
    }
})

3.2 Delete a Bucket

3.2.1 Definition
provider.deleteBucket(bucketName) //  returns a Promise
3.2.2 Full Example
const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('azure', {
    accountName: 'accountName',
    accountKey: 'accountKey'
})

let bucketName = 'example'
provider.deleteBucket(bucketName).then((resp) => {
    if (resp.status === 200) {
        console.log(resp.message) 
        // Output: Bucket "example" was deleted successfully
    }
}).catch((resp) => {
    if (resp.status === 400){
        console.log(resp.message) 
        // Output: Some error coming from the provider...
    }
})

3.3 Save object into a Bucket

3.3.1 Definition
provider.saveObjectIntoBucket(bucketName, filename, object) // returns a Promise
3.3.2 Full Example
const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('azure', {
    accountName: 'accountName',
    accountKey: 'accountKey'
})

let bucketName = 'example'
let filename = 'my_remote_object.txt'
let object = {
    name: 'This is my name',
    surname: 'This is my surname',
    age: 30
}
provider.saveObjectIntoBucket(bucketName, filename, object).then((resp) => {
    if (resp.status === 200) {
        console.log(resp.message) 
        // Output: Object "example.txt" was saved successfully in bucket "example"
    }
}).catch((resp) => {
    if (resp.status === 400){
        console.log(resp.message)
        // Output: Some error coming from the provider...
    }
})

3.4 Delete object from Bucket

3.4.1 Definition
provider.deleteObjectFromBucket(bucketName, filename) // returns a Promise
3.4.2 Full Example
const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('azure', {
    accountName: 'accountName',
    accountKey: 'accountKey'
})

let bucketName = 'example'
let filename = 'my_remote_object.txt'

provider.deleteObjectFromBucket(bucketName, filename).then((resp) => {
    if (resp.status === 200) {
        console.log(resp.message) 
        // Output: Object "example.txt" was deleted successfully from bucket "example"
    }
}).catch((resp) => {
    if (resp.status === 400){
        console.log(resp.message)
        // Output: Some error coming from the provider...
    }
})

3.5 Get object from Bucket

3.5.1 Definition
provider.getObjectFromBucket(bucketName, filename) // returns a Promise
3.5.2 Full Example
const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('azure', {
    accountName: 'accountName',
    accountKey: 'accountKey'
})

let bucketName = 'example'
let filename = 'my_remote_object.txt'
provider.getObjectFromBucket(bucketName, filename).then((resp) => {
    if (resp.status === 200) {
        console.log(resp.message) 
        // Output: Object "example.txt" was fetched successfully from bucket "example"
    }
}).catch((resp) => {
    if (resp.status === 400){
        console.log(resp.message)
        // Output: Some error coming from the provider...
    }
})

3.6 Get list of objects from Bucket

3.6.1 Definition
provider.getListOfObjectsFromBucket(bucketName) // returns a Promise
3.6.2 Full Example
const SolidBucket = require('solid-bucket')

let provider = new SolidBucket('azure', {
    accountName: 'accountName',
    accountKey: 'accountKey'
})

let bucketName = 'example'
provider.getListOfObjectsFromBucket(bucketName).then((resp) => {
    if (resp.status === 200) {
        console.log(resp.message) 
        // Output: The list of objects was fetched successfully from bucket "example"
    }
}).catch((resp) => {
    if (resp.status === 400){
        console.log(resp.message)
        // Output: Some error coming from the provider...
    }
})

4. Tests

Required Environmental vars depending on the provider:

Amazon AWS S3
  • AWS_ACCESSKEYID
  • AWS_SECRETACCESSKEY
Backblaze B2
  • B2_ACCOUNTID
  • B2_APPLICATIONKEY
DigitalOcean Spaces
  • DIGITALOCEAN_ACCESSKEYID
  • DIGITALOCEAN_SECRETACCESSKEY
Google Cloud Storage
  • GCS_PROJECTID
  • GCS_PRIVATEKEYID
  • GCS_PRIVATEKEY
  • GCS_CLIENTEMAIL
  • GCS_CLIENTID
  • GCS_CLIENTX509CERTURL
Microsoft Azure
  • AZURE_ACCOUNTNAME
  • AZURE_ACCOUNTKEY
Rackspace Cloud Storage
  • RACKSPACE_USERNAME
  • RACKSPACE_APIKEY
Wasabi Object Storage
  • WASABI_ACCESSKEYID
  • WASABI_SECRETACCESSKEY
Any S3 Compatible Storage
  • S3COMPATIBLE_ENDPOINT
  • S3COMPATIBLE_ACCESSKEYID
  • S3COMPATIBLE_SECRETACCESSKEY
Folder
  • FOLDER_FOLDERPATH

Afterwards, just run:

npm test

5. License

MIT

Keywords

FAQs

Last updated on 11 Feb 2018

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc