@dispatchcms/next 0.0.7 → 0.0.8

package/README.md

@@ -148,3 +148,14 @@ export default async function PreviewPage({
 ```
 
 In the CMS, set **Site URL** in Site settings to your site’s base URL (e.g. `https://yoursite.com`). The preview link will use that URL plus `/preview?token=...`.
+
+## Images
+
+An image field is a URL until an editor drags a point, then `{ url, focus }`. `imageProps` reads both. It only changes which part of the photo stays in view when your frame crops it.
+
+```tsx
+import { imageProps } from "@dispatchcms/next";
+
+const photo = imageProps(entry.data.hero);
+photo ? <img src={photo.src} alt="" className="h-full w-full" style={photo.style} /> : null
+```

package/dist/index.d.mts

@@ -22,5 +22,12 @@ declare function getEntries(collection: string, siteKey?: string): Promise<Entry
 declare function getEntry(collection: string, slug: string, siteKey?: string): Promise<Entry | null>;
 /** Draft or published entry. The token is the secret; no site key is required. */
 declare function getEntryByPreviewToken(token: string): Promise<Entry | null>;
+declare function imageProps(value: unknown): {
+    src: string;
+    style: {
+        objectFit: "cover";
+        objectPosition: string;
+    };
+} | null;
 
-export { type DispatchConfig, type Entry, getConfig, getEntries, getEntry, getEntryByPreviewToken, initDispatch };
+export { type DispatchConfig, type Entry, getConfig, getEntries, getEntry, getEntryByPreviewToken, imageProps, initDispatch };

package/dist/index.d.ts

@@ -22,5 +22,12 @@ declare function getEntries(collection: string, siteKey?: string): Promise<Entry
 declare function getEntry(collection: string, slug: string, siteKey?: string): Promise<Entry | null>;
 /** Draft or published entry. The token is the secret; no site key is required. */
 declare function getEntryByPreviewToken(token: string): Promise<Entry | null>;
+declare function imageProps(value: unknown): {
+    src: string;
+    style: {
+        objectFit: "cover";
+        objectPosition: string;
+    };
+} | null;
 
-export { type DispatchConfig, type Entry, getConfig, getEntries, getEntry, getEntryByPreviewToken, initDispatch };
+export { type DispatchConfig, type Entry, getConfig, getEntries, getEntry, getEntryByPreviewToken, imageProps, initDispatch };

package/dist/index.js

@@ -24,6 +24,7 @@ __export(index_exports, {
   getEntries: () => getEntries,
   getEntry: () => getEntry,
   getEntryByPreviewToken: () => getEntryByPreviewToken,
+  imageProps: () => imageProps,
   initDispatch: () => initDispatch
 });
 module.exports = __toCommonJS(index_exports);
@@ -85,12 +86,34 @@ async function getEntryByPreviewToken(token) {
   }
   return await res.json();
 }
+function imageProps(value) {
+  let src = "";
+  let x = 0.5;
+  let y = 0.5;
+  if (typeof value === "string") {
+    src = value;
+  } else if (value && typeof value === "object" && !Array.isArray(value)) {
+    const row = value;
+    if (typeof row.url !== "string") return null;
+    src = row.url;
+    if (row.focus && typeof row.focus === "object" && !Array.isArray(row.focus)) {
+      const focus = row.focus;
+      if (typeof focus.x === "number" && Number.isFinite(focus.x)) x = Math.min(1, Math.max(0, focus.x));
+      if (typeof focus.y === "number" && Number.isFinite(focus.y)) y = Math.min(1, Math.max(0, focus.y));
+    }
+  } else {
+    return null;
+  }
+  if (!src) return null;
+  return { src, style: { objectFit: "cover", objectPosition: `${x * 100}% ${y * 100}%` } };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getConfig,
   getEntries,
   getEntry,
   getEntryByPreviewToken,
+  imageProps,
   initDispatch
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export type { Entry, DispatchConfig } from \"./client\";\nexport {\n  initDispatch,\n  getConfig,\n  getEntries,\n  getEntry,\n  getEntryByPreviewToken,\n} from \"./client\";\n","export type Entry = {\n  id: string;\n  created_at: string;\n  published_at: string | null;\n  updated_at: string;\n  site_id: string;\n  collection: string;\n  title: string;\n  slug: string | null;\n  data: Record<string, unknown>;\n  sort_order: number;\n  published: boolean;\n};\n\nconst DISPATCH_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport type DispatchConfig = {\n  siteKey: string;\n};\n\nlet config: DispatchConfig | null = null;\n\nexport function initDispatch(options: DispatchConfig): void {\n  config = { siteKey: options.siteKey };\n}\n\nexport function getConfig(): { siteKey: string } {\n  const envKey = typeof process !== \"undefined\" ? process.env?.NEXT_PUBLIC_DISPATCH_SITE_KEY : undefined;\n  const siteKey = config?.siteKey ?? (typeof envKey === \"string\" ? envKey : undefined);\n  if (!siteKey || typeof siteKey !== \"string\") {\n    throw new Error(\"Dispatch site key is required. Call initDispatch({ siteKey }) or set NEXT_PUBLIC_DISPATCH_SITE_KEY.\");\n  }\n  return { siteKey };\n}\n\nexport async function getEntries(collection: string, siteKey?: string): Promise<Entry[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entries: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry[];\n}\n\nexport async function getEntry(collection: string, slug: string, siteKey?: string): Promise<Entry | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}/${encodeURIComponent(slug)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (res.status === 404) {\n    return null;\n  }\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entry: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n\n/** Draft or published entry. The token is the secret; no site key is required. */\nexport async function getEntryByPreviewToken(token: string): Promise<Entry | null> {\n  if (!token?.trim()) return null;\n  const url = `${DISPATCH_API_BASE}/api/preview?token=${encodeURIComponent(token.trim())}`;\n  const res = await fetch(url);\n  if (res.status === 404) return null;\n  if (!res.ok) {\n    throw new Error(`Failed to fetch preview: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcA,IAAM,oBAAoB;AAM1B,IAAI,SAAgC;AAE7B,SAAS,aAAa,SAA+B;AAC1D,WAAS,EAAE,SAAS,QAAQ,QAAQ;AACtC;AAEO,SAAS,YAAiC;AAC/C,QAAM,SAAS,OAAO,YAAY,cAAc,QAAQ,KAAK,gCAAgC;AAC7F,QAAM,UAAU,QAAQ,YAAY,OAAO,WAAW,WAAW,SAAS;AAC1E,MAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,UAAM,IAAI,MAAM,qGAAqG;AAAA,EACvH;AACA,SAAO,EAAE,QAAQ;AACnB;AAEA,eAAsB,WAAW,YAAoB,SAAoC;AACvF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC;AAC9E,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAEA,eAAsB,SAAS,YAAoB,MAAc,SAAyC;AACxG,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC,IAAI,mBAAmB,IAAI,CAAC;AAC1G,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,IAAI,WAAW,KAAK;AACtB,WAAO;AAAA,EACT;AACA,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC1E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAGA,eAAsB,uBAAuB,OAAsC;AACjF,MAAI,CAAC,OAAO,KAAK,EAAG,QAAO;AAC3B,QAAM,MAAM,GAAG,iBAAiB,sBAAsB,mBAAmB,MAAM,KAAK,CAAC,CAAC;AACtF,QAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,MAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export type { Entry, DispatchConfig } from \"./client\";\nexport {\n  initDispatch,\n  getConfig,\n  getEntries,\n  getEntry,\n  getEntryByPreviewToken,\n  imageProps,\n} from \"./client\";\n","export type Entry = {\n  id: string;\n  created_at: string;\n  published_at: string | null;\n  updated_at: string;\n  site_id: string;\n  collection: string;\n  title: string;\n  slug: string | null;\n  data: Record<string, unknown>;\n  sort_order: number;\n  published: boolean;\n};\n\nconst DISPATCH_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport type DispatchConfig = {\n  siteKey: string;\n};\n\nlet config: DispatchConfig | null = null;\n\nexport function initDispatch(options: DispatchConfig): void {\n  config = { siteKey: options.siteKey };\n}\n\nexport function getConfig(): { siteKey: string } {\n  const envKey = typeof process !== \"undefined\" ? process.env?.NEXT_PUBLIC_DISPATCH_SITE_KEY : undefined;\n  const siteKey = config?.siteKey ?? (typeof envKey === \"string\" ? envKey : undefined);\n  if (!siteKey || typeof siteKey !== \"string\") {\n    throw new Error(\"Dispatch site key is required. Call initDispatch({ siteKey }) or set NEXT_PUBLIC_DISPATCH_SITE_KEY.\");\n  }\n  return { siteKey };\n}\n\nexport async function getEntries(collection: string, siteKey?: string): Promise<Entry[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entries: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry[];\n}\n\nexport async function getEntry(collection: string, slug: string, siteKey?: string): Promise<Entry | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}/${encodeURIComponent(slug)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (res.status === 404) {\n    return null;\n  }\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entry: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n\n/** Draft or published entry. The token is the secret; no site key is required. */\nexport async function getEntryByPreviewToken(token: string): Promise<Entry | null> {\n  if (!token?.trim()) return null;\n  const url = `${DISPATCH_API_BASE}/api/preview?token=${encodeURIComponent(token.trim())}`;\n  const res = await fetch(url);\n  if (res.status === 404) return null;\n  if (!res.ok) {\n    throw new Error(`Failed to fetch preview: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n\n// ponytail: percentage object-position. Measure the image against the frame if a subject still clips.\nexport function imageProps(value: unknown): {\n  src: string;\n  style: { objectFit: \"cover\"; objectPosition: string };\n} | null {\n  let src = \"\";\n  let x = 0.5;\n  let y = 0.5;\n  if (typeof value === \"string\") {\n    src = value;\n  } else if (value && typeof value === \"object\" && !Array.isArray(value)) {\n    const row = value as Record<string, unknown>;\n    if (typeof row.url !== \"string\") return null;\n    src = row.url;\n    if (row.focus && typeof row.focus === \"object\" && !Array.isArray(row.focus)) {\n      const focus = row.focus as Record<string, unknown>;\n      if (typeof focus.x === \"number\" && Number.isFinite(focus.x)) x = Math.min(1, Math.max(0, focus.x));\n      if (typeof focus.y === \"number\" && Number.isFinite(focus.y)) y = Math.min(1, Math.max(0, focus.y));\n    }\n  } else {\n    return null;\n  }\n  if (!src) return null;\n  return { src, style: { objectFit: \"cover\", objectPosition: `${x * 100}% ${y * 100}%` } };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcA,IAAM,oBAAoB;AAM1B,IAAI,SAAgC;AAE7B,SAAS,aAAa,SAA+B;AAC1D,WAAS,EAAE,SAAS,QAAQ,QAAQ;AACtC;AAEO,SAAS,YAAiC;AAC/C,QAAM,SAAS,OAAO,YAAY,cAAc,QAAQ,KAAK,gCAAgC;AAC7F,QAAM,UAAU,QAAQ,YAAY,OAAO,WAAW,WAAW,SAAS;AAC1E,MAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,UAAM,IAAI,MAAM,qGAAqG;AAAA,EACvH;AACA,SAAO,EAAE,QAAQ;AACnB;AAEA,eAAsB,WAAW,YAAoB,SAAoC;AACvF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC;AAC9E,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAEA,eAAsB,SAAS,YAAoB,MAAc,SAAyC;AACxG,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC,IAAI,mBAAmB,IAAI,CAAC;AAC1G,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,IAAI,WAAW,KAAK;AACtB,WAAO;AAAA,EACT;AACA,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC1E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAGA,eAAsB,uBAAuB,OAAsC;AACjF,MAAI,CAAC,OAAO,KAAK,EAAG,QAAO;AAC3B,QAAM,MAAM,GAAG,iBAAiB,sBAAsB,mBAAmB,MAAM,KAAK,CAAC,CAAC;AACtF,QAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,MAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAGO,SAAS,WAAW,OAGlB;AACP,MAAI,MAAM;AACV,MAAI,IAAI;AACR,MAAI,IAAI;AACR,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM;AAAA,EACR,WAAW,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACtE,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,QAAQ,SAAU,QAAO;AACxC,UAAM,IAAI;AACV,QAAI,IAAI,SAAS,OAAO,IAAI,UAAU,YAAY,CAAC,MAAM,QAAQ,IAAI,KAAK,GAAG;AAC3E,YAAM,QAAQ,IAAI;AAClB,UAAI,OAAO,MAAM,MAAM,YAAY,OAAO,SAAS,MAAM,CAAC,EAAG,KAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC,CAAC;AACjG,UAAI,OAAO,MAAM,MAAM,YAAY,OAAO,SAAS,MAAM,CAAC,EAAG,KAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC,CAAC;AAAA,IACnG;AAAA,EACF,OAAO;AACL,WAAO;AAAA,EACT;AACA,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,EAAE,KAAK,OAAO,EAAE,WAAW,SAAS,gBAAgB,GAAG,IAAI,GAAG,KAAK,IAAI,GAAG,IAAI,EAAE;AACzF;","names":[]}

package/dist/index.mjs

@@ -55,11 +55,33 @@ async function getEntryByPreviewToken(token) {
   }
   return await res.json();
 }
+function imageProps(value) {
+  let src = "";
+  let x = 0.5;
+  let y = 0.5;
+  if (typeof value === "string") {
+    src = value;
+  } else if (value && typeof value === "object" && !Array.isArray(value)) {
+    const row = value;
+    if (typeof row.url !== "string") return null;
+    src = row.url;
+    if (row.focus && typeof row.focus === "object" && !Array.isArray(row.focus)) {
+      const focus = row.focus;
+      if (typeof focus.x === "number" && Number.isFinite(focus.x)) x = Math.min(1, Math.max(0, focus.x));
+      if (typeof focus.y === "number" && Number.isFinite(focus.y)) y = Math.min(1, Math.max(0, focus.y));
+    }
+  } else {
+    return null;
+  }
+  if (!src) return null;
+  return { src, style: { objectFit: "cover", objectPosition: `${x * 100}% ${y * 100}%` } };
+}
 export {
   getConfig,
   getEntries,
   getEntry,
   getEntryByPreviewToken,
+  imageProps,
   initDispatch
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["export type Entry = {\n  id: string;\n  created_at: string;\n  published_at: string | null;\n  updated_at: string;\n  site_id: string;\n  collection: string;\n  title: string;\n  slug: string | null;\n  data: Record<string, unknown>;\n  sort_order: number;\n  published: boolean;\n};\n\nconst DISPATCH_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport type DispatchConfig = {\n  siteKey: string;\n};\n\nlet config: DispatchConfig | null = null;\n\nexport function initDispatch(options: DispatchConfig): void {\n  config = { siteKey: options.siteKey };\n}\n\nexport function getConfig(): { siteKey: string } {\n  const envKey = typeof process !== \"undefined\" ? process.env?.NEXT_PUBLIC_DISPATCH_SITE_KEY : undefined;\n  const siteKey = config?.siteKey ?? (typeof envKey === \"string\" ? envKey : undefined);\n  if (!siteKey || typeof siteKey !== \"string\") {\n    throw new Error(\"Dispatch site key is required. Call initDispatch({ siteKey }) or set NEXT_PUBLIC_DISPATCH_SITE_KEY.\");\n  }\n  return { siteKey };\n}\n\nexport async function getEntries(collection: string, siteKey?: string): Promise<Entry[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entries: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry[];\n}\n\nexport async function getEntry(collection: string, slug: string, siteKey?: string): Promise<Entry | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}/${encodeURIComponent(slug)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (res.status === 404) {\n    return null;\n  }\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entry: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n\n/** Draft or published entry. The token is the secret; no site key is required. */\nexport async function getEntryByPreviewToken(token: string): Promise<Entry | null> {\n  if (!token?.trim()) return null;\n  const url = `${DISPATCH_API_BASE}/api/preview?token=${encodeURIComponent(token.trim())}`;\n  const res = await fetch(url);\n  if (res.status === 404) return null;\n  if (!res.ok) {\n    throw new Error(`Failed to fetch preview: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n"],"mappings":";AAcA,IAAM,oBAAoB;AAM1B,IAAI,SAAgC;AAE7B,SAAS,aAAa,SAA+B;AAC1D,WAAS,EAAE,SAAS,QAAQ,QAAQ;AACtC;AAEO,SAAS,YAAiC;AAC/C,QAAM,SAAS,OAAO,YAAY,cAAc,QAAQ,KAAK,gCAAgC;AAC7F,QAAM,UAAU,QAAQ,YAAY,OAAO,WAAW,WAAW,SAAS;AAC1E,MAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,UAAM,IAAI,MAAM,qGAAqG;AAAA,EACvH;AACA,SAAO,EAAE,QAAQ;AACnB;AAEA,eAAsB,WAAW,YAAoB,SAAoC;AACvF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC;AAC9E,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAEA,eAAsB,SAAS,YAAoB,MAAc,SAAyC;AACxG,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC,IAAI,mBAAmB,IAAI,CAAC;AAC1G,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,IAAI,WAAW,KAAK;AACtB,WAAO;AAAA,EACT;AACA,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC1E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAGA,eAAsB,uBAAuB,OAAsC;AACjF,MAAI,CAAC,OAAO,KAAK,EAAG,QAAO;AAC3B,QAAM,MAAM,GAAG,iBAAiB,sBAAsB,mBAAmB,MAAM,KAAK,CAAC,CAAC;AACtF,QAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,MAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;","names":[]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["export type Entry = {\n  id: string;\n  created_at: string;\n  published_at: string | null;\n  updated_at: string;\n  site_id: string;\n  collection: string;\n  title: string;\n  slug: string | null;\n  data: Record<string, unknown>;\n  sort_order: number;\n  published: boolean;\n};\n\nconst DISPATCH_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport type DispatchConfig = {\n  siteKey: string;\n};\n\nlet config: DispatchConfig | null = null;\n\nexport function initDispatch(options: DispatchConfig): void {\n  config = { siteKey: options.siteKey };\n}\n\nexport function getConfig(): { siteKey: string } {\n  const envKey = typeof process !== \"undefined\" ? process.env?.NEXT_PUBLIC_DISPATCH_SITE_KEY : undefined;\n  const siteKey = config?.siteKey ?? (typeof envKey === \"string\" ? envKey : undefined);\n  if (!siteKey || typeof siteKey !== \"string\") {\n    throw new Error(\"Dispatch site key is required. Call initDispatch({ siteKey }) or set NEXT_PUBLIC_DISPATCH_SITE_KEY.\");\n  }\n  return { siteKey };\n}\n\nexport async function getEntries(collection: string, siteKey?: string): Promise<Entry[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entries: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry[];\n}\n\nexport async function getEntry(collection: string, slug: string, siteKey?: string): Promise<Entry | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const url = `${DISPATCH_API_BASE}/api/content/${encodeURIComponent(collection)}/${encodeURIComponent(slug)}`;\n  const res = await fetch(url, {\n    headers: { \"X-Site-Key\": resolvedKey },\n  });\n  if (res.status === 404) {\n    return null;\n  }\n  if (!res.ok) {\n    if (res.status === 401) {\n      throw new Error(\"Invalid or missing site key\");\n    }\n    throw new Error(`Failed to fetch entry: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n\n/** Draft or published entry. The token is the secret; no site key is required. */\nexport async function getEntryByPreviewToken(token: string): Promise<Entry | null> {\n  if (!token?.trim()) return null;\n  const url = `${DISPATCH_API_BASE}/api/preview?token=${encodeURIComponent(token.trim())}`;\n  const res = await fetch(url);\n  if (res.status === 404) return null;\n  if (!res.ok) {\n    throw new Error(`Failed to fetch preview: ${res.status} ${res.statusText}`);\n  }\n  return (await res.json()) as Entry;\n}\n\n// ponytail: percentage object-position. Measure the image against the frame if a subject still clips.\nexport function imageProps(value: unknown): {\n  src: string;\n  style: { objectFit: \"cover\"; objectPosition: string };\n} | null {\n  let src = \"\";\n  let x = 0.5;\n  let y = 0.5;\n  if (typeof value === \"string\") {\n    src = value;\n  } else if (value && typeof value === \"object\" && !Array.isArray(value)) {\n    const row = value as Record<string, unknown>;\n    if (typeof row.url !== \"string\") return null;\n    src = row.url;\n    if (row.focus && typeof row.focus === \"object\" && !Array.isArray(row.focus)) {\n      const focus = row.focus as Record<string, unknown>;\n      if (typeof focus.x === \"number\" && Number.isFinite(focus.x)) x = Math.min(1, Math.max(0, focus.x));\n      if (typeof focus.y === \"number\" && Number.isFinite(focus.y)) y = Math.min(1, Math.max(0, focus.y));\n    }\n  } else {\n    return null;\n  }\n  if (!src) return null;\n  return { src, style: { objectFit: \"cover\", objectPosition: `${x * 100}% ${y * 100}%` } };\n}\n"],"mappings":";AAcA,IAAM,oBAAoB;AAM1B,IAAI,SAAgC;AAE7B,SAAS,aAAa,SAA+B;AAC1D,WAAS,EAAE,SAAS,QAAQ,QAAQ;AACtC;AAEO,SAAS,YAAiC;AAC/C,QAAM,SAAS,OAAO,YAAY,cAAc,QAAQ,KAAK,gCAAgC;AAC7F,QAAM,UAAU,QAAQ,YAAY,OAAO,WAAW,WAAW,SAAS;AAC1E,MAAI,CAAC,WAAW,OAAO,YAAY,UAAU;AAC3C,UAAM,IAAI,MAAM,qGAAqG;AAAA,EACvH;AACA,SAAO,EAAE,QAAQ;AACnB;AAEA,eAAsB,WAAW,YAAoB,SAAoC;AACvF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC;AAC9E,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAEA,eAAsB,SAAS,YAAoB,MAAc,SAAyC;AACxG,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,MAAM,GAAG,iBAAiB,gBAAgB,mBAAmB,UAAU,CAAC,IAAI,mBAAmB,IAAI,CAAC;AAC1G,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS,EAAE,cAAc,YAAY;AAAA,EACvC,CAAC;AACD,MAAI,IAAI,WAAW,KAAK;AACtB,WAAO;AAAA,EACT;AACA,MAAI,CAAC,IAAI,IAAI;AACX,QAAI,IAAI,WAAW,KAAK;AACtB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,UAAM,IAAI,MAAM,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC1E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAGA,eAAsB,uBAAuB,OAAsC;AACjF,MAAI,CAAC,OAAO,KAAK,EAAG,QAAO;AAC3B,QAAM,MAAM,GAAG,iBAAiB,sBAAsB,mBAAmB,MAAM,KAAK,CAAC,CAAC;AACtF,QAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,MAAI,IAAI,WAAW,IAAK,QAAO;AAC/B,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,IAAI,MAAM,4BAA4B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC5E;AACA,SAAQ,MAAM,IAAI,KAAK;AACzB;AAGO,SAAS,WAAW,OAGlB;AACP,MAAI,MAAM;AACV,MAAI,IAAI;AACR,MAAI,IAAI;AACR,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM;AAAA,EACR,WAAW,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,GAAG;AACtE,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,QAAQ,SAAU,QAAO;AACxC,UAAM,IAAI;AACV,QAAI,IAAI,SAAS,OAAO,IAAI,UAAU,YAAY,CAAC,MAAM,QAAQ,IAAI,KAAK,GAAG;AAC3E,YAAM,QAAQ,IAAI;AAClB,UAAI,OAAO,MAAM,MAAM,YAAY,OAAO,SAAS,MAAM,CAAC,EAAG,KAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC,CAAC;AACjG,UAAI,OAAO,MAAM,MAAM,YAAY,OAAO,SAAS,MAAM,CAAC,EAAG,KAAI,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC,CAAC;AAAA,IACnG;AAAA,EACF,OAAO;AACL,WAAO;AAAA,EACT;AACA,MAAI,CAAC,IAAK,QAAO;AACjB,SAAO,EAAE,KAAK,OAAO,EAAE,WAAW,SAAS,gBAAgB,GAAG,IAAI,GAAG,KAAK,IAAI,GAAG,IAAI,EAAE;AACzF;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dispatchcms/next",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Fetch published entries from a Dispatch CMS in Next.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -12,6 +12,11 @@
       "require": "./dist/index.js"
     }
   },
+  "scripts": {
+    "build": "tsup",
+    "test": "tsx test/client.cache.test.ts && tsx test/image-props.test.ts",
+    "test:manual": "tsx test/getPage.test.ts"
+  },
   "devDependencies": {
     "@types/node": "^22.20.1",
     "next": "^16.3.0",
@@ -31,10 +36,5 @@
   "license": "MIT",
   "peerDependencies": {
     "next": ">=16.0.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "test": "tsx test/client.cache.test.ts",
-    "test:manual": "tsx test/getPage.test.ts"
   }
-}
+}

package/src/client.ts

@@ -79,3 +79,29 @@ export async function getEntryByPreviewToken(token: string): Promise<Entry | nul
   }
   return (await res.json()) as Entry;
 }
+
+// ponytail: percentage object-position. Measure the image against the frame if a subject still clips.
+export function imageProps(value: unknown): {
+  src: string;
+  style: { objectFit: "cover"; objectPosition: string };
+} | null {
+  let src = "";
+  let x = 0.5;
+  let y = 0.5;
+  if (typeof value === "string") {
+    src = value;
+  } else if (value && typeof value === "object" && !Array.isArray(value)) {
+    const row = value as Record<string, unknown>;
+    if (typeof row.url !== "string") return null;
+    src = row.url;
+    if (row.focus && typeof row.focus === "object" && !Array.isArray(row.focus)) {
+      const focus = row.focus as Record<string, unknown>;
+      if (typeof focus.x === "number" && Number.isFinite(focus.x)) x = Math.min(1, Math.max(0, focus.x));
+      if (typeof focus.y === "number" && Number.isFinite(focus.y)) y = Math.min(1, Math.max(0, focus.y));
+    }
+  } else {
+    return null;
+  }
+  if (!src) return null;
+  return { src, style: { objectFit: "cover", objectPosition: `${x * 100}% ${y * 100}%` } };
+}

package/src/index.ts

@@ -5,4 +5,5 @@ export {
   getEntries,
   getEntry,
   getEntryByPreviewToken,
+  imageProps,
 } from "./client";

package/test/image-props.test.ts

@@ -0,0 +1,13 @@
+import { imageProps } from "../src/index";
+
+function assert(condition: boolean, message: string): void {
+  if (!condition) throw new Error(`Assertion failed: ${message}`);
+}
+
+const url = "https://cdn.example/a.jpg";
+const plain = imageProps(url);
+assert(plain?.src === url && plain.style.objectFit === "cover" && plain.style.objectPosition === "50% 50%", "string url");
+const focused = imageProps({ url, focus: { x: 0.2, y: 0.8 } });
+assert(focused?.src === url && focused.style.objectPosition === "20% 80%", "focus object");
+assert(imageProps(null) === null && imageProps("") === null && imageProps({}) === null, "bad input");
+console.log("image props ok");