An *unofficial* package to easily deal with Backblaze API on Node.js:. 

An unofficial package to easily deal with Backblaze B2 API

franciscop

alxhotel

backblaze

An *unofficial* package to easily deal with Backblaze API on Node.js:

  "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",

const writeFile = promisify(fs.writeFile);

export default function (name, { id = env.B2_ID, key = env.B2_KEY } = {}) {

  const b2 = new B2({ applicationKeyId: id, applicationKey: key });

  const bucketProm = new Promise(async (done, fail) => {

      await b2.authorize(); // must authorize first

      const list = await b2.listBuckets();

      done(list.data.buckets.find((b) => b.bucketName === name));

      console.log("AUTH", error.request.res);

      console.error("AUTH", error.request.res);

    const res = await b2.listFileNames({ bucketId });

    return res.data.files.map((file) => file.fileName);

  const download = async (remote, local) => {

    local = local || nanoid() + "." + remote.split(".").pop();

    const down = await b2.downloadFileByName({

    return path.resolve(process.cwd(), local);

  const upload = async (local, remote) => {

    remote = remote || nanoid() + "." + local.split(".").pop();

    const [res, data] = await Promise.all([

    const { authorizationToken, uploadUrl } = res.data;

    const uploaded = await b2.uploadFile({

      uploadAuthToken: authorizationToken,

    const fullFile = res.data.files.find((f) => f.fileName === file);

  return { info, list, count, exists, upload, download, remove };

  "author": "Francisco Presencia <public@francisco.io> (https://francisco.io/)",

    "testEnvironment": "jest-environment-node"

  id: process.env.B2_ID,   // Use an id-key that are not master for security

// Upload a file from a local file to an auto-generated name

const remote = await bucket.upload('./avatar.png');

// Let's download it now as a copy locally

await bucket.download(remote, './avatar-copy.png');

> Please note that relative file paths are relative to the **working directory** [as specified on Node.js' fs](https://nodejs.org/api/fs.html#fs_file_paths). You can always provide absolute paths.

All of the methods are async and are related to a single bucket. You can work with multiple buckets as well by creating them as expected:

const bucket1 = Bucket('bucket-name-1', { ... });

const bucket2 = Bucket('bucket-name-2', { ... });

The main function is synchronous, but all of the methods are async so they should be used with `await`:

const bucket = Backblaze('bucket-name', { id, key });

const file = await bucket.upload('./avatar.png');

// [{ path: 'avatar.png', ... }, { path: 'profile.png', ...}, ...]

file.url    // https://service.com/bucket-name/public/avatar.png

Create an instance associated to a bucket. It receives first the bucket name, and then an object with the config:

No need for `new` or `await`. Internally it will start loading the bucket as soon as initialized like this, and if it hasn't loaded by the time it's used then it will await on the first operation for it.

The `id` and `key`, and the second parameter altogether, can be skipped if the environment variables `B2_ID` and `B2_KEY` have been set respectively:

Load some information related to the bucket itself:

Show a list with the filenames of the files in your bucket. It displays all of the filenames in the bucket including any subfolders:

// [ 'avatar.png', 'users/abc.png', ... ]

Display the number of items inside a bucket, including sub-folder files:

bucket.upload(localFilePath, [remoteFileName]) => remoteFileName

- `localFilePath` (required): the path to the file to be uploaded. It will be relative to the **working directory** [as specified on Node.js' fs](https://nodejs.org/api/fs.html#fs_file_paths). TODO: accept a byte sequence.

- `remoteFileName` (optional): the name of the file in the bucket. Leave it empty to autogenerate the name. We are purposefully avoiding reusing the `localFilePath` name to avoid collisions and other issues.

// Just upload a file and get the path in the response:

// Upload a file inside a folder and specify the remote name:

await bucket.upload('./public/favicon.png', 'favicon.png');

// Upload a file to a folder in the bucket:

await bucket.upload('./avatar.png', 'public/favicon.png');

await bucket.upload(__dirname + '/avatar.png', 'favicon.png')

If you are using a modern Node.js version that doesn't define `__dirname`, you can create `__dirname` like this:

const __dirname = dirname(fileURLToPath(import.meta.url));

		@@ -26,3 +26,3 @@ import fs from "fs";
		} catch (error) {
		console.log("AUTH", error.request.res);
		console.error("AUTH", error.request.res);
		fail(error);
		@@ -29,0 +29,0 @@ }

		{
		"name": "backblaze",
		"version": "1.1.1",
		"version": "1.1.2",
		"description": "",
		@@ -5,0 +5,0 @@ "main": "index.js",

		@@ -62,9 +62,3 @@ # Backblaze
		console.log(await bucket.list());
		// [{ path: 'avatar.png', ... }, { path: 'profile.png', ...}, ...]

		file.id // dfgadfbvrt
		file.path // public/avatar.png
		file.dir // public/
		file.name // avatar.png
		file.url // https://service.com/bucket-name/public/avatar.png
		// ['avatar.png', 'profile.png', ...]
		```
		@@ -71,0 +65,0 @@

Worsened metrics