Node.js and TypeScript media SDK

// npm install dreep
import fs from "node:fs";
import { Dreep } from "dreep";

const dreep = new Dreep({
  apiKey: process.env.DREEP_API_KEY, // "drp_live_..."
  signingSecret: process.env.DREEP_SIGNING_SECRET, // optional
});

// Resized and converted to WebP before it is stored
const asset = await dreep.upload({
  file: fs.createReadStream("hero.jpg"),
  folder: "marketing/2026",
  transform: { width: 1200, format: "webp" },
});

asset.url; // https://cdn.dreep.cloud/api/v1/fetch/2f928a3f-...
dreep.url(asset, { width: 400 }); // no network call

curl -X POST https://api.dreep.cloud/api/v1/upload \
  -H "Authorization: Bearer $DREEP_API_KEY" \
  -F "file=@hero.jpg" \
  -F "folder=marketing/2026" \
  -F "width=1200" \
  -F "format=webp"

// A Buffer carries no name, so pass one
const avatar = await dreep.upload({
  file: buffer,
  filename: "me.jpg",
  key: "avatars/2026/q1/me.webp",
  transform: { width: 512, height: 512, fit: "cover", format: "webp", quality: 80 },
});

// Fail instead of creating folders for an unknown path
await dreep.upload({ file, folder: "invoices/2026", autoCreateFolders: false });

// Apply a saved preset on the way in
await dreep.upload({ file, presetKey: "thumbnail" });

// Server: behind your own auth, after your own quota checks
const startUpload = async ({ userId, filename, contentType, sizeBytes }) => {
  const upload = await dreep.presignUpload({
    filename,
    contentType,
    sizeBytes,
    folder: `users/${userId}`,
  });

  return { id: upload.id, uploadUrl: upload.uploadUrl };
};

const finishUpload = ({ id }) => dreep.confirmUpload({ id });

// Browser: no API key, only the single-use URL
const res = await fetch("/api/uploads", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ filename: file.name, contentType: file.type, sizeBytes: file.size }),
});
const { id, uploadUrl } = await res.json();

await fetch(uploadUrl, { method: "PUT", body: file, headers: { "Content-Type": file.type } });
await fetch(`/api/uploads/${id}/confirm`, { method: "POST" });

dreep.url(asset, { width: 800, format: "avif", quality: 70 });
dreep.url(asset, { width: 1200, height: 630, fit: "cover", gravity: "attention" });
dreep.url(storedUrlString, { width: 400 }); // works on a saved URL too

// Save a recipe once, then reference it by key
await dreep.createPreset({
  key: "thumbnail",
  name: "Thumbnail",
  transform: { width: 200, height: 200, fit: "cover", format: "webp" },
});
dreep.url(asset, { preset: "thumbnail" }); // ...?p=thumbnail

// Assets in a signed folder: time-limited, signed locally
dreep.signedUrl(asset, { expiresIn: 3600 });
dreep.signedUrl(asset, { expiresIn: 900, transform: { width: 800 } });

const { text, blocks, savedAsset } = await dreep.extractText({
  file: fs.createReadStream("receipt.jpg"),
  folder: "receipts/2026", // optional: also save the text
});

// OCR on an asset already in Dreep: request the txt format
const ocr = await fetch(dreep.url(asset, { format: "txt" }));
const pageText = await ocr.text();

const cutout = await dreep.removeBackground({
  file: fs.createReadStream("shoe.jpg"),
  folder: "products",
});
dreep.url(cutout, { bg: "ffffff" }); // any background colour, no new removal

import { DreepError, DreepLimitError } from "dreep";

try {
  const asset = await dreep.upload({
    file,
    folder: "avatars",
    signal: AbortSignal.timeout(120_000),
  });
  return asset.url;
} catch (error) {
  if (error instanceof DreepLimitError) {
    // e.g. storage full: upgrade or buy an add-on, there is no automatic overage
    console.log(error.featureKey, error.used, error.limit);
  } else if (error instanceof DreepError) {
    console.log(error.status, error.message);
  }
}