@betttercms/image-url 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# @betttercms/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
+
+```bash
+npm install @betttercms/image-url
+```
+
+## Usage
+
+```ts
+import imageUrlBuilder from "@betttercms/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:
+
+```ts
+import { imageUrl } from "@betttercms/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.

package/dist/index.cjs

@@ -0,0 +1,81 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default,
+  imageUrl: () => imageUrl,
+  imageUrlBuilder: () => imageUrlBuilder
+});
+module.exports = __toCommonJS(index_exports);
+var DEFAULT_BASE_URL = "https://media.bettercms.ai";
+function resolveId(source) {
+  const raw = typeof source === "string" ? source : source.id ?? source._id ?? source.url ?? source.src ?? "";
+  if (!raw) throw new Error("[image-url] cannot resolve an asset id from source");
+  if (!raw.includes("/")) return raw;
+  const path = raw.split("?")[0].split("#")[0];
+  const segments = path.split("/").filter(Boolean);
+  const mediaIdx = segments.indexOf("media");
+  const id = mediaIdx >= 0 ? segments[mediaIdx + 1] : segments[segments.length - 1];
+  if (!id) throw new Error(`[image-url] cannot resolve an asset id from "${raw}"`);
+  return id;
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+function makeBuilder(baseUrl, id, t) {
+  const next = (patch) => makeBuilder(baseUrl, id, { ...t, ...patch });
+  const build = () => {
+    const params = new URLSearchParams();
+    if (t.w != null) params.set("w", String(Math.round(t.w)));
+    if (t.h != null) params.set("h", String(Math.round(t.h)));
+    if (t.format) params.set("format", t.format === "jpg" ? "jpeg" : t.format);
+    if (t.quality != null) params.set("quality", String(clamp(t.quality, 1, 100)));
+    if (t.fit) params.set("fit", t.fit);
+    if (t.dpr != null && t.dpr !== 1) params.set("dpr", String(clamp(t.dpr, 1, 3)));
+    const qs = params.toString();
+    return `${baseUrl}/media/${id}${qs ? `?${qs}` : ""}`;
+  };
+  return {
+    width: (v) => next({ w: v }),
+    height: (v) => next({ h: v }),
+    size: (w, h) => next({ w, h }),
+    format: (v) => next({ format: v }),
+    quality: (v) => next({ quality: v }),
+    fit: (v) => next({ fit: v }),
+    dpr: (v) => next({ dpr: v }),
+    url: build,
+    toString: build
+  };
+}
+function imageUrlBuilder(options = {}) {
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  return (source) => makeBuilder(baseUrl, resolveId(source), {});
+}
+function imageUrl(source, options) {
+  return imageUrlBuilder(options)(source);
+}
+var index_default = imageUrlBuilder;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  imageUrl,
+  imageUrlBuilder
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @betttercms/image-url — chainable, immutable builder for optimized\n * BetterCMS image URLs. Mirrors the ergonomics of `@sanity/image-url`.\n *\n *   import imageUrlBuilder from \"@betttercms/image-url\";\n *   const urlFor = imageUrlBuilder({ baseUrl: \"https://media.bettercms.ai\" });\n *   urlFor(asset).width(800).format(\"webp\").url();\n *\n * The builder only assembles URLs against the backend media transform\n * endpoint (`GET /media/:id?w&h&format&quality&fit&dpr`). It performs no I/O.\n */\n\n/** A value the builder can resolve an asset id from. */\nexport type ImageSource =\n  | string\n  | { id?: string; _id?: string; url?: string; src?: string };\n\nexport type ImageFormat = \"webp\" | \"jpeg\" | \"jpg\" | \"png\" | \"avif\";\n\n/** Resize behaviour, passed through to the server-side sharp pipeline. */\nexport type ImageFit = \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n\nexport interface ImageUrlOptions {\n  /** Media host base, no trailing slash. Defaults to the prod media host. */\n  baseUrl?: string;\n}\n\nconst DEFAULT_BASE_URL = \"https://media.bettercms.ai\";\n\ninterface Transform {\n  w?: number;\n  h?: number;\n  format?: ImageFormat;\n  quality?: number;\n  fit?: ImageFit;\n  dpr?: number;\n}\n\nexport interface ImageUrlBuilder {\n  width(value: number): ImageUrlBuilder;\n  height(value: number): ImageUrlBuilder;\n  /** Set width and height together. */\n  size(width: number, height: number): ImageUrlBuilder;\n  format(value: ImageFormat): ImageUrlBuilder;\n  /** Output quality, 1–100. */\n  quality(value: number): ImageUrlBuilder;\n  fit(value: ImageFit): ImageUrlBuilder;\n  /** Device pixel ratio multiplier, 1–3. */\n  dpr(value: number): ImageUrlBuilder;\n  /** Render the final URL string. */\n  url(): string;\n  /** Alias for {@link url}. */\n  toString(): string;\n}\n\n/** Resolve the asset id from any accepted source shape. */\nfunction resolveId(source: ImageSource): string {\n  const raw =\n    typeof source === \"string\"\n      ? source\n      : source.id ?? source._id ?? source.url ?? source.src ?? \"\";\n  if (!raw) throw new Error(\"[image-url] cannot resolve an asset id from source\");\n\n  // A bare id (no slashes) is used as-is.\n  if (!raw.includes(\"/\")) return raw;\n\n  // Otherwise treat it as a URL/path: prefer the segment after `/media/`,\n  // falling back to the last non-empty path segment.\n  const path = raw.split(\"?\")[0]!.split(\"#\")[0]!;\n  const segments = path.split(\"/\").filter(Boolean);\n  const mediaIdx = segments.indexOf(\"media\");\n  const id = mediaIdx >= 0 ? segments[mediaIdx + 1] : segments[segments.length - 1];\n  if (!id) throw new Error(`[image-url] cannot resolve an asset id from \"${raw}\"`);\n  return id;\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value));\n}\n\nfunction makeBuilder(baseUrl: string, id: string, t: Transform): ImageUrlBuilder {\n  const next = (patch: Partial<Transform>): ImageUrlBuilder =>\n    makeBuilder(baseUrl, id, { ...t, ...patch });\n\n  const build = (): string => {\n    const params = new URLSearchParams();\n    if (t.w != null) params.set(\"w\", String(Math.round(t.w)));\n    if (t.h != null) params.set(\"h\", String(Math.round(t.h)));\n    if (t.format) params.set(\"format\", t.format === \"jpg\" ? \"jpeg\" : t.format);\n    if (t.quality != null) params.set(\"quality\", String(clamp(t.quality, 1, 100)));\n    if (t.fit) params.set(\"fit\", t.fit);\n    if (t.dpr != null && t.dpr !== 1) params.set(\"dpr\", String(clamp(t.dpr, 1, 3)));\n    const qs = params.toString();\n    return `${baseUrl}/media/${id}${qs ? `?${qs}` : \"\"}`;\n  };\n\n  return {\n    width: (v) => next({ w: v }),\n    height: (v) => next({ h: v }),\n    size: (w, h) => next({ w, h }),\n    format: (v) => next({ format: v }),\n    quality: (v) => next({ quality: v }),\n    fit: (v) => next({ fit: v }),\n    dpr: (v) => next({ dpr: v }),\n    url: build,\n    toString: build,\n  };\n}\n\n/**\n * Create a builder factory bound to a media host. The returned function\n * starts a fresh, immutable chain for a given image source.\n */\nexport function imageUrlBuilder(\n  options: ImageUrlOptions = {},\n): (source: ImageSource) => ImageUrlBuilder {\n  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n  return (source: ImageSource) => makeBuilder(baseUrl, resolveId(source), {});\n}\n\n/** One-shot convenience: `imageUrl(asset, { baseUrl }).width(800).url()`. */\nexport function imageUrl(\n  source: ImageSource,\n  options?: ImageUrlOptions,\n): ImageUrlBuilder {\n  return imageUrlBuilder(options)(source);\n}\n\nexport default imageUrlBuilder;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA2BA,IAAM,mBAAmB;AA6BzB,SAAS,UAAU,QAA6B;AAC9C,QAAM,MACJ,OAAO,WAAW,WACd,SACA,OAAO,MAAM,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO;AAC7D,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,oDAAoD;AAG9E,MAAI,CAAC,IAAI,SAAS,GAAG,EAAG,QAAO;AAI/B,QAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC,EAAG,MAAM,GAAG,EAAE,CAAC;AAC5C,QAAM,WAAW,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAC/C,QAAM,WAAW,SAAS,QAAQ,OAAO;AACzC,QAAM,KAAK,YAAY,IAAI,SAAS,WAAW,CAAC,IAAI,SAAS,SAAS,SAAS,CAAC;AAChF,MAAI,CAAC,GAAI,OAAM,IAAI,MAAM,gDAAgD,GAAG,GAAG;AAC/E,SAAO;AACT;AAEA,SAAS,MAAM,OAAe,KAAa,KAAqB;AAC9D,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC3C;AAEA,SAAS,YAAY,SAAiB,IAAY,GAA+B;AAC/E,QAAM,OAAO,CAAC,UACZ,YAAY,SAAS,IAAI,EAAE,GAAG,GAAG,GAAG,MAAM,CAAC;AAE7C,QAAM,QAAQ,MAAc;AAC1B,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,EAAE,KAAK,KAAM,QAAO,IAAI,KAAK,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;AACxD,QAAI,EAAE,KAAK,KAAM,QAAO,IAAI,KAAK,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;AACxD,QAAI,EAAE,OAAQ,QAAO,IAAI,UAAU,EAAE,WAAW,QAAQ,SAAS,EAAE,MAAM;AACzE,QAAI,EAAE,WAAW,KAAM,QAAO,IAAI,WAAW,OAAO,MAAM,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC;AAC7E,QAAI,EAAE,IAAK,QAAO,IAAI,OAAO,EAAE,GAAG;AAClC,QAAI,EAAE,OAAO,QAAQ,EAAE,QAAQ,EAAG,QAAO,IAAI,OAAO,OAAO,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAC9E,UAAM,KAAK,OAAO,SAAS;AAC3B,WAAO,GAAG,OAAO,UAAU,EAAE,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE;AAAA,EACpD;AAEA,SAAO;AAAA,IACL,OAAO,CAAC,MAAM,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,IAC3B,QAAQ,CAAC,MAAM,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,IAC5B,MAAM,CAAC,GAAG,MAAM,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,IAC7B,QAAQ,CAAC,MAAM,KAAK,EAAE,QAAQ,EAAE,CAAC;AAAA,IACjC,SAAS,CAAC,MAAM,KAAK,EAAE,SAAS,EAAE,CAAC;AAAA,IACnC,KAAK,CAAC,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;AAAA,IAC3B,KAAK,CAAC,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;AAAA,IAC3B,KAAK;AAAA,IACL,UAAU;AAAA,EACZ;AACF;AAMO,SAAS,gBACd,UAA2B,CAAC,GACc;AAC1C,QAAM,WAAW,QAAQ,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AACxE,SAAO,CAAC,WAAwB,YAAY,SAAS,UAAU,MAAM,GAAG,CAAC,CAAC;AAC5E;AAGO,SAAS,SACd,QACA,SACiB;AACjB,SAAO,gBAAgB,OAAO,EAAE,MAAM;AACxC;AAEA,IAAO,gBAAQ;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+/**
+ * @betttercms/image-url — chainable, immutable builder for optimized
+ * BetterCMS image URLs. Mirrors the ergonomics of `@sanity/image-url`.
+ *
+ *   import imageUrlBuilder from "@betttercms/image-url";
+ *   const urlFor = imageUrlBuilder({ baseUrl: "https://media.bettercms.ai" });
+ *   urlFor(asset).width(800).format("webp").url();
+ *
+ * The builder only assembles URLs against the backend media transform
+ * endpoint (`GET /media/:id?w&h&format&quality&fit&dpr`). It performs no I/O.
+ */
+/** A value the builder can resolve an asset id from. */
+type ImageSource = string | {
+    id?: string;
+    _id?: string;
+    url?: string;
+    src?: string;
+};
+type ImageFormat = "webp" | "jpeg" | "jpg" | "png" | "avif";
+/** Resize behaviour, passed through to the server-side sharp pipeline. */
+type ImageFit = "cover" | "contain" | "fill" | "inside" | "outside";
+interface ImageUrlOptions {
+    /** Media host base, no trailing slash. Defaults to the prod media host. */
+    baseUrl?: string;
+}
+interface ImageUrlBuilder {
+    width(value: number): ImageUrlBuilder;
+    height(value: number): ImageUrlBuilder;
+    /** Set width and height together. */
+    size(width: number, height: number): ImageUrlBuilder;
+    format(value: ImageFormat): ImageUrlBuilder;
+    /** Output quality, 1–100. */
+    quality(value: number): ImageUrlBuilder;
+    fit(value: ImageFit): ImageUrlBuilder;
+    /** Device pixel ratio multiplier, 1–3. */
+    dpr(value: number): ImageUrlBuilder;
+    /** Render the final URL string. */
+    url(): string;
+    /** Alias for {@link url}. */
+    toString(): string;
+}
+/**
+ * Create a builder factory bound to a media host. The returned function
+ * starts a fresh, immutable chain for a given image source.
+ */
+declare function imageUrlBuilder(options?: ImageUrlOptions): (source: ImageSource) => ImageUrlBuilder;
+/** One-shot convenience: `imageUrl(asset, { baseUrl }).width(800).url()`. */
+declare function imageUrl(source: ImageSource, options?: ImageUrlOptions): ImageUrlBuilder;
+
+export { type ImageFit, type ImageFormat, type ImageSource, type ImageUrlBuilder, type ImageUrlOptions, imageUrlBuilder as default, imageUrl, imageUrlBuilder };

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @betttercms/image-url — chainable, immutable builder for optimized
+ * BetterCMS image URLs. Mirrors the ergonomics of `@sanity/image-url`.
+ *
+ *   import imageUrlBuilder from "@betttercms/image-url";
+ *   const urlFor = imageUrlBuilder({ baseUrl: "https://media.bettercms.ai" });
+ *   urlFor(asset).width(800).format("webp").url();
+ *
+ * The builder only assembles URLs against the backend media transform
+ * endpoint (`GET /media/:id?w&h&format&quality&fit&dpr`). It performs no I/O.
+ */
+/** A value the builder can resolve an asset id from. */
+type ImageSource = string | {
+    id?: string;
+    _id?: string;
+    url?: string;
+    src?: string;
+};
+type ImageFormat = "webp" | "jpeg" | "jpg" | "png" | "avif";
+/** Resize behaviour, passed through to the server-side sharp pipeline. */
+type ImageFit = "cover" | "contain" | "fill" | "inside" | "outside";
+interface ImageUrlOptions {
+    /** Media host base, no trailing slash. Defaults to the prod media host. */
+    baseUrl?: string;
+}
+interface ImageUrlBuilder {
+    width(value: number): ImageUrlBuilder;
+    height(value: number): ImageUrlBuilder;
+    /** Set width and height together. */
+    size(width: number, height: number): ImageUrlBuilder;
+    format(value: ImageFormat): ImageUrlBuilder;
+    /** Output quality, 1–100. */
+    quality(value: number): ImageUrlBuilder;
+    fit(value: ImageFit): ImageUrlBuilder;
+    /** Device pixel ratio multiplier, 1–3. */
+    dpr(value: number): ImageUrlBuilder;
+    /** Render the final URL string. */
+    url(): string;
+    /** Alias for {@link url}. */
+    toString(): string;
+}
+/**
+ * Create a builder factory bound to a media host. The returned function
+ * starts a fresh, immutable chain for a given image source.
+ */
+declare function imageUrlBuilder(options?: ImageUrlOptions): (source: ImageSource) => ImageUrlBuilder;
+/** One-shot convenience: `imageUrl(asset, { baseUrl }).width(800).url()`. */
+declare function imageUrl(source: ImageSource, options?: ImageUrlOptions): ImageUrlBuilder;
+
+export { type ImageFit, type ImageFormat, type ImageSource, type ImageUrlBuilder, type ImageUrlOptions, imageUrlBuilder as default, imageUrl, imageUrlBuilder };

package/dist/index.js

@@ -0,0 +1,55 @@
+// src/index.ts
+var DEFAULT_BASE_URL = "https://media.bettercms.ai";
+function resolveId(source) {
+  const raw = typeof source === "string" ? source : source.id ?? source._id ?? source.url ?? source.src ?? "";
+  if (!raw) throw new Error("[image-url] cannot resolve an asset id from source");
+  if (!raw.includes("/")) return raw;
+  const path = raw.split("?")[0].split("#")[0];
+  const segments = path.split("/").filter(Boolean);
+  const mediaIdx = segments.indexOf("media");
+  const id = mediaIdx >= 0 ? segments[mediaIdx + 1] : segments[segments.length - 1];
+  if (!id) throw new Error(`[image-url] cannot resolve an asset id from "${raw}"`);
+  return id;
+}
+function clamp(value, min, max) {
+  return Math.min(max, Math.max(min, value));
+}
+function makeBuilder(baseUrl, id, t) {
+  const next = (patch) => makeBuilder(baseUrl, id, { ...t, ...patch });
+  const build = () => {
+    const params = new URLSearchParams();
+    if (t.w != null) params.set("w", String(Math.round(t.w)));
+    if (t.h != null) params.set("h", String(Math.round(t.h)));
+    if (t.format) params.set("format", t.format === "jpg" ? "jpeg" : t.format);
+    if (t.quality != null) params.set("quality", String(clamp(t.quality, 1, 100)));
+    if (t.fit) params.set("fit", t.fit);
+    if (t.dpr != null && t.dpr !== 1) params.set("dpr", String(clamp(t.dpr, 1, 3)));
+    const qs = params.toString();
+    return `${baseUrl}/media/${id}${qs ? `?${qs}` : ""}`;
+  };
+  return {
+    width: (v) => next({ w: v }),
+    height: (v) => next({ h: v }),
+    size: (w, h) => next({ w, h }),
+    format: (v) => next({ format: v }),
+    quality: (v) => next({ quality: v }),
+    fit: (v) => next({ fit: v }),
+    dpr: (v) => next({ dpr: v }),
+    url: build,
+    toString: build
+  };
+}
+function imageUrlBuilder(options = {}) {
+  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+  return (source) => makeBuilder(baseUrl, resolveId(source), {});
+}
+function imageUrl(source, options) {
+  return imageUrlBuilder(options)(source);
+}
+var index_default = imageUrlBuilder;
+export {
+  index_default as default,
+  imageUrl,
+  imageUrlBuilder
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @betttercms/image-url — chainable, immutable builder for optimized\n * BetterCMS image URLs. Mirrors the ergonomics of `@sanity/image-url`.\n *\n *   import imageUrlBuilder from \"@betttercms/image-url\";\n *   const urlFor = imageUrlBuilder({ baseUrl: \"https://media.bettercms.ai\" });\n *   urlFor(asset).width(800).format(\"webp\").url();\n *\n * The builder only assembles URLs against the backend media transform\n * endpoint (`GET /media/:id?w&h&format&quality&fit&dpr`). It performs no I/O.\n */\n\n/** A value the builder can resolve an asset id from. */\nexport type ImageSource =\n  | string\n  | { id?: string; _id?: string; url?: string; src?: string };\n\nexport type ImageFormat = \"webp\" | \"jpeg\" | \"jpg\" | \"png\" | \"avif\";\n\n/** Resize behaviour, passed through to the server-side sharp pipeline. */\nexport type ImageFit = \"cover\" | \"contain\" | \"fill\" | \"inside\" | \"outside\";\n\nexport interface ImageUrlOptions {\n  /** Media host base, no trailing slash. Defaults to the prod media host. */\n  baseUrl?: string;\n}\n\nconst DEFAULT_BASE_URL = \"https://media.bettercms.ai\";\n\ninterface Transform {\n  w?: number;\n  h?: number;\n  format?: ImageFormat;\n  quality?: number;\n  fit?: ImageFit;\n  dpr?: number;\n}\n\nexport interface ImageUrlBuilder {\n  width(value: number): ImageUrlBuilder;\n  height(value: number): ImageUrlBuilder;\n  /** Set width and height together. */\n  size(width: number, height: number): ImageUrlBuilder;\n  format(value: ImageFormat): ImageUrlBuilder;\n  /** Output quality, 1–100. */\n  quality(value: number): ImageUrlBuilder;\n  fit(value: ImageFit): ImageUrlBuilder;\n  /** Device pixel ratio multiplier, 1–3. */\n  dpr(value: number): ImageUrlBuilder;\n  /** Render the final URL string. */\n  url(): string;\n  /** Alias for {@link url}. */\n  toString(): string;\n}\n\n/** Resolve the asset id from any accepted source shape. */\nfunction resolveId(source: ImageSource): string {\n  const raw =\n    typeof source === \"string\"\n      ? source\n      : source.id ?? source._id ?? source.url ?? source.src ?? \"\";\n  if (!raw) throw new Error(\"[image-url] cannot resolve an asset id from source\");\n\n  // A bare id (no slashes) is used as-is.\n  if (!raw.includes(\"/\")) return raw;\n\n  // Otherwise treat it as a URL/path: prefer the segment after `/media/`,\n  // falling back to the last non-empty path segment.\n  const path = raw.split(\"?\")[0]!.split(\"#\")[0]!;\n  const segments = path.split(\"/\").filter(Boolean);\n  const mediaIdx = segments.indexOf(\"media\");\n  const id = mediaIdx >= 0 ? segments[mediaIdx + 1] : segments[segments.length - 1];\n  if (!id) throw new Error(`[image-url] cannot resolve an asset id from \"${raw}\"`);\n  return id;\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n  return Math.min(max, Math.max(min, value));\n}\n\nfunction makeBuilder(baseUrl: string, id: string, t: Transform): ImageUrlBuilder {\n  const next = (patch: Partial<Transform>): ImageUrlBuilder =>\n    makeBuilder(baseUrl, id, { ...t, ...patch });\n\n  const build = (): string => {\n    const params = new URLSearchParams();\n    if (t.w != null) params.set(\"w\", String(Math.round(t.w)));\n    if (t.h != null) params.set(\"h\", String(Math.round(t.h)));\n    if (t.format) params.set(\"format\", t.format === \"jpg\" ? \"jpeg\" : t.format);\n    if (t.quality != null) params.set(\"quality\", String(clamp(t.quality, 1, 100)));\n    if (t.fit) params.set(\"fit\", t.fit);\n    if (t.dpr != null && t.dpr !== 1) params.set(\"dpr\", String(clamp(t.dpr, 1, 3)));\n    const qs = params.toString();\n    return `${baseUrl}/media/${id}${qs ? `?${qs}` : \"\"}`;\n  };\n\n  return {\n    width: (v) => next({ w: v }),\n    height: (v) => next({ h: v }),\n    size: (w, h) => next({ w, h }),\n    format: (v) => next({ format: v }),\n    quality: (v) => next({ quality: v }),\n    fit: (v) => next({ fit: v }),\n    dpr: (v) => next({ dpr: v }),\n    url: build,\n    toString: build,\n  };\n}\n\n/**\n * Create a builder factory bound to a media host. The returned function\n * starts a fresh, immutable chain for a given image source.\n */\nexport function imageUrlBuilder(\n  options: ImageUrlOptions = {},\n): (source: ImageSource) => ImageUrlBuilder {\n  const baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/+$/, \"\");\n  return (source: ImageSource) => makeBuilder(baseUrl, resolveId(source), {});\n}\n\n/** One-shot convenience: `imageUrl(asset, { baseUrl }).width(800).url()`. */\nexport function imageUrl(\n  source: ImageSource,\n  options?: ImageUrlOptions,\n): ImageUrlBuilder {\n  return imageUrlBuilder(options)(source);\n}\n\nexport default imageUrlBuilder;\n"],"mappings":";AA2BA,IAAM,mBAAmB;AA6BzB,SAAS,UAAU,QAA6B;AAC9C,QAAM,MACJ,OAAO,WAAW,WACd,SACA,OAAO,MAAM,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO;AAC7D,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,oDAAoD;AAG9E,MAAI,CAAC,IAAI,SAAS,GAAG,EAAG,QAAO;AAI/B,QAAM,OAAO,IAAI,MAAM,GAAG,EAAE,CAAC,EAAG,MAAM,GAAG,EAAE,CAAC;AAC5C,QAAM,WAAW,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAC/C,QAAM,WAAW,SAAS,QAAQ,OAAO;AACzC,QAAM,KAAK,YAAY,IAAI,SAAS,WAAW,CAAC,IAAI,SAAS,SAAS,SAAS,CAAC;AAChF,MAAI,CAAC,GAAI,OAAM,IAAI,MAAM,gDAAgD,GAAG,GAAG;AAC/E,SAAO;AACT;AAEA,SAAS,MAAM,OAAe,KAAa,KAAqB;AAC9D,SAAO,KAAK,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC;AAC3C;AAEA,SAAS,YAAY,SAAiB,IAAY,GAA+B;AAC/E,QAAM,OAAO,CAAC,UACZ,YAAY,SAAS,IAAI,EAAE,GAAG,GAAG,GAAG,MAAM,CAAC;AAE7C,QAAM,QAAQ,MAAc;AAC1B,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,EAAE,KAAK,KAAM,QAAO,IAAI,KAAK,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;AACxD,QAAI,EAAE,KAAK,KAAM,QAAO,IAAI,KAAK,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;AACxD,QAAI,EAAE,OAAQ,QAAO,IAAI,UAAU,EAAE,WAAW,QAAQ,SAAS,EAAE,MAAM;AACzE,QAAI,EAAE,WAAW,KAAM,QAAO,IAAI,WAAW,OAAO,MAAM,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC;AAC7E,QAAI,EAAE,IAAK,QAAO,IAAI,OAAO,EAAE,GAAG;AAClC,QAAI,EAAE,OAAO,QAAQ,EAAE,QAAQ,EAAG,QAAO,IAAI,OAAO,OAAO,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAC9E,UAAM,KAAK,OAAO,SAAS;AAC3B,WAAO,GAAG,OAAO,UAAU,EAAE,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE;AAAA,EACpD;AAEA,SAAO;AAAA,IACL,OAAO,CAAC,MAAM,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,IAC3B,QAAQ,CAAC,MAAM,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,IAC5B,MAAM,CAAC,GAAG,MAAM,KAAK,EAAE,GAAG,EAAE,CAAC;AAAA,IAC7B,QAAQ,CAAC,MAAM,KAAK,EAAE,QAAQ,EAAE,CAAC;AAAA,IACjC,SAAS,CAAC,MAAM,KAAK,EAAE,SAAS,EAAE,CAAC;AAAA,IACnC,KAAK,CAAC,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;AAAA,IAC3B,KAAK,CAAC,MAAM,KAAK,EAAE,KAAK,EAAE,CAAC;AAAA,IAC3B,KAAK;AAAA,IACL,UAAU;AAAA,EACZ;AACF;AAMO,SAAS,gBACd,UAA2B,CAAC,GACc;AAC1C,QAAM,WAAW,QAAQ,WAAW,kBAAkB,QAAQ,QAAQ,EAAE;AACxE,SAAO,CAAC,WAAwB,YAAY,SAAS,UAAU,MAAM,GAAG,CAAC,CAAC;AAC5E;AAGO,SAAS,SACd,QACA,SACiB;AACjB,SAAO,gBAAgB,OAAO,EAAE,MAAM;AACxC;AAEA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@betttercms/image-url",
+  "version": "0.1.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Build optimized BetterCMS image URLs with a chainable, immutable builder.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "@betttercms/types": "^1.2.0",
+    "tsup": "^8.5.1",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}