@bettercms-ai/image-url
Chainable, immutable builder for optimized BetterCMS image URLs — the
@sanity/image-url of BetterCMS. Zero runtime dependencies; assembles URLs
against the media transform endpoint (GET /media/:id?w&h&format&quality&fit&dpr).
Install
npm install @bettercms-ai/image-url
Usage
import imageUrlBuilder from "@bettercms-ai/image-url";
const urlFor = imageUrlBuilder({ baseUrl: "https://media.bettercms.ai" });
// From an asset id, a MediaAsset object, or an existing media URL:
urlFor(asset).width(800).format("webp").quality(80).url();
// → https://media.bettercms.ai/media/<id>?w=800&format=webp&quality=80
One-shot helper:
import { imageUrl } from "@bettercms-ai/image-url";
imageUrl(asset).size(400, 300).fit("cover").dpr(2).url();
Builder methods
| Method | Param → query |
|---|---|
.width(n) / .height(n) | w / h (rounded) |
.size(w, h) | w + h |
.format(f) | format (webp|jpeg|png|avif; jpg→jpeg) |
.quality(q) | quality (clamped 1–100) |
.fit(f) | fit (cover|contain|fill|inside|outside) |
.dpr(d) | dpr (clamped 1–3; omitted when 1) |
.url() / .toString() | render |
baseUrl defaults to https://media.bettercms.ai. Every method returns a new
builder, so chains are safe to fork.