@squarecloud/blob

@squarecloud/blob

Official Square Cloud Blob SDK for NodeJS.

Installation

npm install @squarecloud/blob
// or
yarn add @squarecloud/blob
// or
pnpm add @squarecloud/blob

Documentation

Visit our official API documentation for more information about this service.

Getting Started

• Login and get your API Key at https://squarecloud.app/account.

import { SquareCloudBlob } from "@squarecloud/blob"
// CommonJS => const { SquareCloudBlob } = require("@squarecloud/blob");

const blob = new SquareCloudBlob("Your API Key")
const objects = await blob.objects.list()

Creating an object

• Check supported file types here.

const blobObject = await blob.objects.create({
  file: "path/to/file.png", // Absolute path to your file
  name: "my_image",         // File name without extension
})

console.log(blobObject.url)

Advanced usage with Buffer

import { MimeTypes } from "@squarecloud/blob"
// CommonJS => const { MimeTypes } = require("@squarecloud/blob")

const blobObject = await blob.objects.create({
  file: Buffer.from("content"),
  name: "my_image",
  mimeType: MimeTypes.IMAGE_JPEG, // Also accepts an string "image/jpeg"
})

console.log(blobObject.url)

Deleting objects

// List of objects to delete (Limit of 100 per request)
const objectsToDelete = [
  "ID/prefix/name1_xxx-xxx.mp4",
  "ID/prefix/name_xxx-xxx-xxx.png"
]

await blob.objects.delete(objectsToDelete)

Contributing

Feel free to contribute with suggestions or bug reports at our GitHub repository.

Authors

• @joaotonaco

Changelog

1.0.0

Major Changes

• a88b29b: Rename objects.put and related to objects.create
• a88b29b: Update to new Blob API routes

Minor Changes

• a73de9f: New mimeType prop for objects.put method, required if file is a Buffer
• 3810094: objects.put now returns useful info about the uploaded object

Patch Changes

• 1407c2f: Export some typings and mimeType enum
• 3f5c7b8: Fix objects.list method