npm install manage-storage

bun i manage-storage

import { StorageManager } from "manage-storage";

// Credentials come from the environment; the provider is detected from them.
const storage = new StorageManager();

await storage.upload("documents/report.pdf", fileContent);
const data: string = await storage.download("documents/report.pdf");
const keys: string[] = await storage.list();

await storage.copy("documents/report.pdf", "documents/report-backup.pdf");
await storage.rename("documents/old-name.pdf", "documents/new-name.pdf");
await storage.delete("documents/report.pdf");

CLOUDFLARE_BUCKET_NAME=my-bucket
CLOUDFLARE_ACCESS_KEY_ID=your-access-key-id
CLOUDFLARE_SECRET_ACCESS_KEY=your-secret-access-key
CLOUDFLARE_BUCKET_URL=https://your-account-id.r2.cloudflarestorage.com

BACKBLAZE_BUCKET_NAME=my-bucket
BACKBLAZE_ACCESS_KEY_ID=your-key-id
BACKBLAZE_SECRET_ACCESS_KEY=your-application-key
BACKBLAZE_BUCKET_URL=https://s3.us-west-004.backblazeb2.com

AMAZON_BUCKET_NAME=my-bucket
AMAZON_ACCESS_KEY_ID=your-access-key-id
AMAZON_SECRET_ACCESS_KEY=your-secret-access-key
AMAZON_BUCKET_URL=https://s3.amazonaws.com
AMAZON_REGION=us-east-1

import { StorageManager } from "manage-storage";

const storage = new StorageManager({
  provider: "cloudflare",
  bucket: "my-bucket",
  accessKeyId: "runtime-key-id",
  secretAccessKey: "runtime-secret",
  endpoint: "https://account-id.r2.cloudflarestorage.com",
});

// app/api/upload/route.ts
import { StorageManager } from "manage-storage";

const storage = new StorageManager();

export async function POST(req: Request): Promise<Response> {
  const { fileName, fileContent } = (await req.json()) as {
    fileName: string;
    fileContent: string;
  };

  return Response.json(await storage.upload(`uploads/${fileName}`, fileContent));
}

export async function GET(req: Request): Promise<Response> {
  const fileName = new URL(req.url).searchParams.get("file");
  if (!fileName) return new Response("file is required", { status: 400 });

  const bytes = await storage.downloadBytes(`uploads/${fileName}`);

  return new Response(bytes, {
    headers: {
      "Content-Type": "application/octet-stream",
      "Content-Disposition": `attachment; filename="${fileName}"`,
    },
  });
}

import express, { type Request, type Response } from "express";
import { StorageManager } from "manage-storage";

const app = express();
const storage = new StorageManager();
app.use(express.json());

app.post("/api/files", async (req: Request, res: Response) => {
  try {
    const { key, content } = req.body as { key: string; content: string };
    res.json(await storage.upload(key, content));
  } catch (error) {
    res.status(500).json({ error: (error as Error).message });
  }
});

app.get("/api/files", async (_req: Request, res: Response) => {
  res.json({ files: await storage.list() });
});

app.get("/api/files/:key", async (req: Request, res: Response) => {
  res.send(await storage.download(req.params.key));
});

app.delete("/api/files/:key", async (req: Request, res: Response) => {
  res.json(await storage.delete(req.params.key));
});

app.listen(3000, () => console.log("Server running on port 3000"));

import { StorageManager } from "manage-storage";

interface Env {
  CLOUDFLARE_BUCKET_NAME: string;
  CLOUDFLARE_ACCESS_KEY_ID: string;
  CLOUDFLARE_SECRET_ACCESS_KEY: string;
  CLOUDFLARE_BUCKET_URL: string;
}

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const storage = new StorageManager({
      provider: "cloudflare",
      bucket: env.CLOUDFLARE_BUCKET_NAME,
      accessKeyId: env.CLOUDFLARE_ACCESS_KEY_ID,
      secretAccessKey: env.CLOUDFLARE_SECRET_ACCESS_KEY,
      endpoint: env.CLOUDFLARE_BUCKET_URL,
    });

    const url = new URL(request.url);

    if (request.method === "POST" && url.pathname === "/upload") {
      const { key, content } = (await request.json()) as {
        key: string;
        content: string;
      };
      return Response.json(await storage.upload(key, content));
    }

    return new Response("Not found", { status: 404 });
  },
};

// upload / delete
{ success: true, key: "path/to/file.txt" }      // plus provider metadata (ETag, …)

// download
"File contents here..."

// list
["folder/file1.txt", "folder/file2.txt"]

// deleteAll
{ success: true, count: 42 }

// copy
{ success: true, sourceKey: "a.pdf", destinationKey: "b.pdf" }

// rename
{ success: true, oldKey: "old.txt", newKey: "new.txt" }