@dispatchcms/react 0.0.6 → 0.0.8

package/README.md

@@ -1,6 +1,6 @@
 # @dispatchcms/react
 
-React hooks and provider for [Dispatch](https://dispatch-cms.vercel.app) CMS. Use `DispatchProvider` and `usePost` / `usePosts` to fetch published posts in any React app (Next.js, Vite, etc.).
+React hooks and provider for [Dispatch](https://dispatch-cms.vercel.app) CMS. Use `DispatchProvider` and `useEntry` / `useEntries` to fetch published entries in any React app (Next.js, Vite, etc.).
 
 ## Install
 
@@ -32,29 +32,29 @@ To use a different API base URL, pass the `apiBase` prop to the provider.
 
 ## API
 
-### `usePost(slug)`
+### `useEntry(collection, slug)`
 
-Fetches a single published post by slug.
+Fetches a single published entry.
 
-- **Returns:** `{ post: Post | null, isLoading: boolean, error?: string }`
-- On failure or missing site key, does not throw; returns `post: null`, `isLoading: false`, and `error` set.
+- **Returns:** `{ entry: Entry | null, isLoading: boolean, error?: string }`
+- On failure or missing site key, does not throw; returns `entry: null`, `isLoading: false`, and `error` set.
 
-### `usePosts()`
+### `useEntries(collection)`
 
-Fetches all published posts for the site.
+Fetches published entries for a collection.
 
-- **Returns:** `{ posts: Post[], isLoading: boolean, error?: string }`
-- On failure or missing site key, does not throw; returns `posts: []`, `isLoading: false`, and `error` set.
+- **Returns:** `{ entries: Entry[], isLoading: boolean, error?: string }`
+- On failure or missing site key, does not throw; returns `entries: []`, `isLoading: false`, and `error` set.
 
 ### Graceful failure
 
-- If the API request fails, hooks return `post: null` / `posts: []`, `isLoading: false`, and `error: "Failed to load"`. The React tree is never crashed.
+- If the API request fails, hooks return `entry: null` / `entries: []`, `isLoading: false`, and `error: "Failed to load"`. The React tree is never crashed.
 - If no `siteKey` is provided to the provider, `console.warn` is logged and hooks return the same safe empty/error state with `error: "Missing site key"`.
 
 ## Types
 
-- **`Post`** – Post from the CMS. Fields include `id`, `title`, `slug`, `content`, `excerpt`, `featured_image`, `published`, `published_at`, `created_at`, `updated_at`, `site_id`. The `content` field is **TipTap (ProseMirror) JSON**.
-- **`UsePostResult`** / **`UsePostsResult`** – Return types of the hooks.
+- **`Entry`** – Entry from a collection. Fields include `id`, `collection`, `title`, `slug`, `data`, `published`, `published_at`, `sort_order`. Rich text values inside `data` are **TipTap (ProseMirror) JSON**.
+- **`UseEntryResult`** / **`UseEntriesResult`** – Return types of the hooks.
 
 ## Rendering content
 
@@ -78,26 +78,26 @@ function TipTapContent({ content }: { content: unknown }) {
 }
 
 // In your post page:
-<TipTapContent content={post.content} />
+<TipTapContent content={entry.data.body} />
 ```
 
 ## Example
 
 ```tsx
 // List posts (e.g. homepage)
-import { usePosts } from "@dispatchcms/react";
+import { useEntries } from "@dispatchcms/react";
 
 export default function HomePage() {
-  const { posts, isLoading, error } = usePosts();
+  const { entries, isLoading, error } = useEntries("posts");
 
   if (isLoading) return <p>Loading…</p>;
   if (error) return <p>{error}</p>;
 
   return (
     <ul>
-      {posts.map((post) => (
-        <li key={post.id}>
-          <a href={`/blog/${post.slug}`}>{post.title}</a>
+      {entries.map((entry) => (
+        <li key={entry.id}>
+          <a href={`/blog/${entry.slug}`}>{entry.title}</a>
         </li>
       ))}
     </ul>
@@ -107,25 +107,35 @@ export default function HomePage() {
 
 ```tsx
 // Single post page (e.g. /blog/:slug)
-import { usePost } from "@dispatchcms/react";
+import { useEntry } from "@dispatchcms/react";
 import { TipTapContent } from "./TipTapContent"; // or inline renderToReactElement
 
 export default function PostPage({ slug }) {
-  const { post, isLoading, error } = usePost(slug);
+  const { entry, isLoading, error } = useEntry("posts", slug);
 
   if (isLoading) return <p>Loading…</p>;
-  if (error || !post) return <p>{error ?? "Not found"}</p>;
+  if (error || !entry) return <p>{error ?? "Not found"}</p>;
 
   return (
     <article>
-      <h1>{post.title}</h1>
-      {post.excerpt && <p>{post.excerpt}</p>}
-      <TipTapContent content={post.content} />
+      <h1>{entry.title}</h1>
+      <TipTapContent content={entry.data.body} />
     </article>
   );
 }
 ```
 
+## 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/react";
+
+const photo = imageProps(entry.data.hero);
+photo ? <img src={photo.src} alt="" className="h-full w-full" style={photo.style} /> : null
+```
+
 ## License
 
 MIT

package/dist/index.d.mts

@@ -1,16 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type Post = {
+type Entry = {
     id: string;
     created_at: string;
-    published_at: string;
+    published_at: string | null;
     updated_at: string;
     site_id: string;
+    collection: string;
     title: string;
-    slug: string;
-    content: unknown;
-    excerpt: string | null;
-    featured_image: string | null;
+    slug: string | null;
+    data: Record<string, unknown>;
+    sort_order: number;
     published: boolean;
 };
 
@@ -26,17 +26,25 @@ type DispatchProviderProps = {
 };
 declare function DispatchProvider({ siteKey, apiBase, children, }: DispatchProviderProps): react_jsx_runtime.JSX.Element;
 
-type UsePostResult = {
-    post: Post | null;
+type UseEntryResult = {
+    entry: Entry | null;
     isLoading: boolean;
     error?: string;
 };
-declare function usePost(slug: string | undefined): UsePostResult;
-type UsePostsResult = {
-    posts: Post[];
+declare function useEntry(collection: string | undefined, slug: string | undefined): UseEntryResult;
+type UseEntriesResult = {
+    entries: Entry[];
     isLoading: boolean;
     error?: string;
 };
-declare function usePosts(): UsePostsResult;
+declare function useEntries(collection: string | undefined): UseEntriesResult;
 
-export { DispatchProvider, type Post, type UsePostResult, type UsePostsResult, useDispatchContext, usePost, usePosts };
+declare function imageProps(value: unknown): {
+    src: string;
+    style: {
+        objectFit: "cover";
+        objectPosition: string;
+    };
+} | null;
+
+export { DispatchProvider, type Entry, type UseEntriesResult, type UseEntryResult, imageProps, useDispatchContext, useEntries, useEntry };

package/dist/index.d.ts

@@ -1,16 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
-type Post = {
+type Entry = {
     id: string;
     created_at: string;
-    published_at: string;
+    published_at: string | null;
     updated_at: string;
     site_id: string;
+    collection: string;
     title: string;
-    slug: string;
-    content: unknown;
-    excerpt: string | null;
-    featured_image: string | null;
+    slug: string | null;
+    data: Record<string, unknown>;
+    sort_order: number;
     published: boolean;
 };
 
@@ -26,17 +26,25 @@ type DispatchProviderProps = {
 };
 declare function DispatchProvider({ siteKey, apiBase, children, }: DispatchProviderProps): react_jsx_runtime.JSX.Element;
 
-type UsePostResult = {
-    post: Post | null;
+type UseEntryResult = {
+    entry: Entry | null;
     isLoading: boolean;
     error?: string;
 };
-declare function usePost(slug: string | undefined): UsePostResult;
-type UsePostsResult = {
-    posts: Post[];
+declare function useEntry(collection: string | undefined, slug: string | undefined): UseEntryResult;
+type UseEntriesResult = {
+    entries: Entry[];
     isLoading: boolean;
     error?: string;
 };
-declare function usePosts(): UsePostsResult;
+declare function useEntries(collection: string | undefined): UseEntriesResult;
 
-export { DispatchProvider, type Post, type UsePostResult, type UsePostsResult, useDispatchContext, usePost, usePosts };
+declare function imageProps(value: unknown): {
+    src: string;
+    style: {
+        objectFit: "cover";
+        objectPosition: string;
+    };
+} | null;
+
+export { DispatchProvider, type Entry, type UseEntriesResult, type UseEntryResult, imageProps, useDispatchContext, useEntries, useEntry };

package/dist/index.js

@@ -22,9 +22,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DispatchProvider: () => DispatchProvider,
+  imageProps: () => imageProps,
   useDispatchContext: () => useDispatchContext,
-  usePost: () => usePost,
-  usePosts: () => usePosts
+  useEntries: () => useEntries,
+  useEntry: () => useEntry
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -64,110 +65,140 @@ function DispatchProvider({
 
 // src/hooks.ts
 var import_react2 = require("react");
-function usePost(slug) {
+function useEntry(collection, slug) {
   const ctx = useDispatchContext();
-  const [post, setPost] = (0, import_react2.useState)(null);
+  const [entry, setEntry] = (0, import_react2.useState)(null);
   const [isLoading, setIsLoading] = (0, import_react2.useState)(true);
   const [error, setError] = (0, import_react2.useState)(void 0);
   (0, import_react2.useEffect)(() => {
-    if (!slug?.trim()) {
-      setPost(null);
+    if (!collection?.trim() || !slug?.trim()) {
+      setEntry(null);
       setIsLoading(false);
       setError(void 0);
       return;
     }
     if (!ctx?.siteKey) {
-      setPost(null);
+      setEntry(null);
       setIsLoading(false);
       setError("Missing site key");
       return;
     }
     let cancelled = false;
-    setPost(null);
+    setEntry(null);
     setError(void 0);
     setIsLoading(true);
-    const url = `${ctx.apiBase}/api/posts/${encodeURIComponent(slug.trim())}`;
+    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}/${encodeURIComponent(slug.trim())}`;
     fetch(url, {
       headers: { "X-Site-Key": ctx.siteKey }
     }).then((res) => {
       if (cancelled) return;
       if (res.status === 404) {
-        setPost(null);
+        setEntry(null);
         setIsLoading(false);
         return;
       }
       if (!res.ok) {
-        setPost(null);
+        setEntry(null);
         setIsLoading(false);
         setError("Failed to load");
         return;
       }
       return res.json();
     }).then((data) => {
-      if (cancelled) return;
-      setPost(data);
+      if (cancelled || data == null) return;
+      setEntry(data);
       setIsLoading(false);
     }).catch(() => {
       if (cancelled) return;
-      setPost(null);
+      setEntry(null);
       setIsLoading(false);
       setError("Failed to load");
     });
     return () => {
       cancelled = true;
     };
-  }, [slug, ctx?.siteKey, ctx?.apiBase]);
-  return { post, isLoading, error };
+  }, [collection, slug, ctx?.siteKey, ctx?.apiBase]);
+  return { entry, isLoading, error };
 }
-function usePosts() {
+function useEntries(collection) {
   const ctx = useDispatchContext();
-  const [posts, setPosts] = (0, import_react2.useState)([]);
+  const [entries, setEntries] = (0, import_react2.useState)([]);
   const [isLoading, setIsLoading] = (0, import_react2.useState)(true);
   const [error, setError] = (0, import_react2.useState)(void 0);
   (0, import_react2.useEffect)(() => {
+    if (!collection?.trim()) {
+      setEntries([]);
+      setIsLoading(false);
+      setError(void 0);
+      return;
+    }
     if (!ctx?.siteKey) {
-      setPosts([]);
+      setEntries([]);
       setIsLoading(false);
       setError("Missing site key");
       return;
     }
     let cancelled = false;
-    setPosts([]);
+    setEntries([]);
     setError(void 0);
     setIsLoading(true);
-    const url = `${ctx.apiBase}/api/posts`;
+    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}`;
     fetch(url, {
       headers: { "X-Site-Key": ctx.siteKey }
     }).then((res) => {
       if (cancelled) return;
       if (!res.ok) {
-        setPosts([]);
+        setEntries([]);
         setIsLoading(false);
         setError("Failed to load");
         return;
       }
       return res.json();
     }).then((data) => {
-      if (cancelled) return;
-      setPosts(Array.isArray(data) ? data : []);
+      if (cancelled || data == null) return;
+      setEntries(Array.isArray(data) ? data : []);
       setIsLoading(false);
     }).catch(() => {
       if (cancelled) return;
-      setPosts([]);
+      setEntries([]);
       setIsLoading(false);
       setError("Failed to load");
     });
     return () => {
       cancelled = true;
     };
-  }, [ctx?.siteKey, ctx?.apiBase]);
-  return { posts, isLoading, error };
+  }, [collection, ctx?.siteKey, ctx?.apiBase]);
+  return { entries, isLoading, error };
+}
+
+// src/index.ts
+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 = {
   DispatchProvider,
+  imageProps,
   useDispatchContext,
-  usePost,
-  usePosts
+  useEntries,
+  useEntry
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/context.tsx","../src/config.ts","../src/hooks.ts"],"sourcesContent":["export type { Post } from \"./types\";\nexport { DispatchProvider, useDispatchContext } from \"./context\";\nexport { usePost, usePosts } from \"./hooks\";\nexport type { UsePostResult, UsePostsResult } from \"./hooks\";\n","\"use client\";\n\nimport React, { createContext, useContext } from \"react\";\nimport { getApiBase } from \"./config\";\n\ntype DispatchContextValue = {\n  siteKey: string | null;\n  apiBase: string;\n};\n\nconst DispatchContext = createContext<DispatchContextValue | null>(null);\n\nexport function useDispatchContext(): DispatchContextValue | null {\n  return useContext(DispatchContext);\n}\n\ntype DispatchProviderProps = {\n  siteKey?: string | null;\n  apiBase?: string;\n  children?: unknown;\n};\n\nexport function DispatchProvider({\n  siteKey = null,\n  apiBase = getApiBase(),\n  children,\n}: DispatchProviderProps) {\n  const value: DispatchContextValue = {\n    siteKey: siteKey?.trim() || null,\n    apiBase,\n  };\n\n  if (!value.siteKey) {\n    if (typeof console !== \"undefined\" && console.warn) {\n      console.warn(\n        \"[Dispatch] No siteKey provided. Pass siteKey to DispatchProvider. Hooks will return empty/error state.\"\n      );\n    }\n  }\n\n  return (\n    <DispatchContext.Provider value={value}>\n      {children as React.ReactNode}\n    </DispatchContext.Provider>\n  );\n}\n","const DEFAULT_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport function getApiBase(): string {\n  return DEFAULT_API_BASE;\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport type { Post } from \"./types\";\nimport { useDispatchContext } from \"./context\";\n\nexport type UsePostResult = {\n  post: Post | null;\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function usePost(slug: string | undefined): UsePostResult {\n  const ctx = useDispatchContext();\n  const [post, setPost] = useState<Post | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!slug?.trim()) {\n      setPost(null);\n      setIsLoading(false);\n      setError(undefined);\n      return;\n    }\n\n    if (!ctx?.siteKey) {\n      setPost(null);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setPost(null);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/posts/${encodeURIComponent(slug.trim())}`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (res.status === 404) {\n          setPost(null);\n          setIsLoading(false);\n          return;\n        }\n        if (!res.ok) {\n          setPost(null);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled) return;\n        setPost(data as Post);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setPost(null);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [slug, ctx?.siteKey, ctx?.apiBase]);\n\n  return { post, isLoading, error };\n}\n\nexport type UsePostsResult = {\n  posts: Post[];\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function usePosts(): UsePostsResult {\n  const ctx = useDispatchContext();\n  const [posts, setPosts] = useState<Post[]>([]);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!ctx?.siteKey) {\n      setPosts([]);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setPosts([]);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/posts`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (!res.ok) {\n          setPosts([]);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled) return;\n        setPosts(Array.isArray(data) ? data : []);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setPosts([]);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [ctx?.siteKey, ctx?.apiBase]);\n\n  return { posts, isLoading, error };\n}\n"],"mappings":"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","names":["import_react"]}
+{"version":3,"sources":["../src/index.ts","../src/context.tsx","../src/config.ts","../src/hooks.ts"],"sourcesContent":["export type { Entry } from \"./types\";\nexport { DispatchProvider, useDispatchContext } from \"./context\";\nexport { useEntry, useEntries } from \"./hooks\";\nexport type { UseEntryResult, UseEntriesResult } from \"./hooks\";\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","\"use client\";\n\nimport React, { createContext, useContext } from \"react\";\nimport { getApiBase } from \"./config\";\n\ntype DispatchContextValue = {\n  siteKey: string | null;\n  apiBase: string;\n};\n\nconst DispatchContext = createContext<DispatchContextValue | null>(null);\n\nexport function useDispatchContext(): DispatchContextValue | null {\n  return useContext(DispatchContext);\n}\n\ntype DispatchProviderProps = {\n  siteKey?: string | null;\n  apiBase?: string;\n  children?: unknown;\n};\n\nexport function DispatchProvider({\n  siteKey = null,\n  apiBase = getApiBase(),\n  children,\n}: DispatchProviderProps) {\n  const value: DispatchContextValue = {\n    siteKey: siteKey?.trim() || null,\n    apiBase,\n  };\n\n  if (!value.siteKey) {\n    if (typeof console !== \"undefined\" && console.warn) {\n      console.warn(\n        \"[Dispatch] No siteKey provided. Pass siteKey to DispatchProvider. Hooks will return empty/error state.\"\n      );\n    }\n  }\n\n  return (\n    <DispatchContext.Provider value={value}>\n      {children as React.ReactNode}\n    </DispatchContext.Provider>\n  );\n}\n","const DEFAULT_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport function getApiBase(): string {\n  return DEFAULT_API_BASE;\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport type { Entry } from \"./types\";\nimport { useDispatchContext } from \"./context\";\n\nexport type UseEntryResult = {\n  entry: Entry | null;\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function useEntry(collection: string | undefined, slug: string | undefined): UseEntryResult {\n  const ctx = useDispatchContext();\n  const [entry, setEntry] = useState<Entry | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!collection?.trim() || !slug?.trim()) {\n      setEntry(null);\n      setIsLoading(false);\n      setError(undefined);\n      return;\n    }\n\n    if (!ctx?.siteKey) {\n      setEntry(null);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setEntry(null);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}/${encodeURIComponent(slug.trim())}`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (res.status === 404) {\n          setEntry(null);\n          setIsLoading(false);\n          return;\n        }\n        if (!res.ok) {\n          setEntry(null);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled || data == null) return;\n        setEntry(data as Entry);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setEntry(null);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [collection, slug, ctx?.siteKey, ctx?.apiBase]);\n\n  return { entry, isLoading, error };\n}\n\nexport type UseEntriesResult = {\n  entries: Entry[];\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function useEntries(collection: string | undefined): UseEntriesResult {\n  const ctx = useDispatchContext();\n  const [entries, setEntries] = useState<Entry[]>([]);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!collection?.trim()) {\n      setEntries([]);\n      setIsLoading(false);\n      setError(undefined);\n      return;\n    }\n\n    if (!ctx?.siteKey) {\n      setEntries([]);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setEntries([]);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (!res.ok) {\n          setEntries([]);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled || data == null) return;\n        setEntries(Array.isArray(data) ? data : []);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setEntries([]);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [collection, ctx?.siteKey, ctx?.apiBase]);\n\n  return { entries, isLoading, error };\n}\n"],"mappings":"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","names":["import_react"]}

package/dist/index.mjs

@@ -36,109 +36,139 @@ function DispatchProvider({
 
 // src/hooks.ts
 import { useEffect, useState } from "react";
-function usePost(slug) {
+function useEntry(collection, slug) {
   const ctx = useDispatchContext();
-  const [post, setPost] = useState(null);
+  const [entry, setEntry] = useState(null);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(void 0);
   useEffect(() => {
-    if (!slug?.trim()) {
-      setPost(null);
+    if (!collection?.trim() || !slug?.trim()) {
+      setEntry(null);
       setIsLoading(false);
       setError(void 0);
       return;
     }
     if (!ctx?.siteKey) {
-      setPost(null);
+      setEntry(null);
       setIsLoading(false);
       setError("Missing site key");
       return;
     }
     let cancelled = false;
-    setPost(null);
+    setEntry(null);
     setError(void 0);
     setIsLoading(true);
-    const url = `${ctx.apiBase}/api/posts/${encodeURIComponent(slug.trim())}`;
+    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}/${encodeURIComponent(slug.trim())}`;
     fetch(url, {
       headers: { "X-Site-Key": ctx.siteKey }
     }).then((res) => {
       if (cancelled) return;
       if (res.status === 404) {
-        setPost(null);
+        setEntry(null);
         setIsLoading(false);
         return;
       }
       if (!res.ok) {
-        setPost(null);
+        setEntry(null);
         setIsLoading(false);
         setError("Failed to load");
         return;
       }
       return res.json();
     }).then((data) => {
-      if (cancelled) return;
-      setPost(data);
+      if (cancelled || data == null) return;
+      setEntry(data);
       setIsLoading(false);
     }).catch(() => {
       if (cancelled) return;
-      setPost(null);
+      setEntry(null);
       setIsLoading(false);
       setError("Failed to load");
     });
     return () => {
       cancelled = true;
     };
-  }, [slug, ctx?.siteKey, ctx?.apiBase]);
-  return { post, isLoading, error };
+  }, [collection, slug, ctx?.siteKey, ctx?.apiBase]);
+  return { entry, isLoading, error };
 }
-function usePosts() {
+function useEntries(collection) {
   const ctx = useDispatchContext();
-  const [posts, setPosts] = useState([]);
+  const [entries, setEntries] = useState([]);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState(void 0);
   useEffect(() => {
+    if (!collection?.trim()) {
+      setEntries([]);
+      setIsLoading(false);
+      setError(void 0);
+      return;
+    }
     if (!ctx?.siteKey) {
-      setPosts([]);
+      setEntries([]);
       setIsLoading(false);
       setError("Missing site key");
       return;
     }
     let cancelled = false;
-    setPosts([]);
+    setEntries([]);
     setError(void 0);
     setIsLoading(true);
-    const url = `${ctx.apiBase}/api/posts`;
+    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}`;
     fetch(url, {
       headers: { "X-Site-Key": ctx.siteKey }
     }).then((res) => {
       if (cancelled) return;
       if (!res.ok) {
-        setPosts([]);
+        setEntries([]);
         setIsLoading(false);
         setError("Failed to load");
         return;
       }
       return res.json();
     }).then((data) => {
-      if (cancelled) return;
-      setPosts(Array.isArray(data) ? data : []);
+      if (cancelled || data == null) return;
+      setEntries(Array.isArray(data) ? data : []);
       setIsLoading(false);
     }).catch(() => {
       if (cancelled) return;
-      setPosts([]);
+      setEntries([]);
       setIsLoading(false);
       setError("Failed to load");
     });
     return () => {
       cancelled = true;
     };
-  }, [ctx?.siteKey, ctx?.apiBase]);
-  return { posts, isLoading, error };
+  }, [collection, ctx?.siteKey, ctx?.apiBase]);
+  return { entries, isLoading, error };
+}
+
+// src/index.ts
+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 {
   DispatchProvider,
+  imageProps,
   useDispatchContext,
-  usePost,
-  usePosts
+  useEntries,
+  useEntry
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context.tsx","../src/config.ts","../src/hooks.ts"],"sourcesContent":["\"use client\";\n\nimport React, { createContext, useContext } from \"react\";\nimport { getApiBase } from \"./config\";\n\ntype DispatchContextValue = {\n  siteKey: string | null;\n  apiBase: string;\n};\n\nconst DispatchContext = createContext<DispatchContextValue | null>(null);\n\nexport function useDispatchContext(): DispatchContextValue | null {\n  return useContext(DispatchContext);\n}\n\ntype DispatchProviderProps = {\n  siteKey?: string | null;\n  apiBase?: string;\n  children?: unknown;\n};\n\nexport function DispatchProvider({\n  siteKey = null,\n  apiBase = getApiBase(),\n  children,\n}: DispatchProviderProps) {\n  const value: DispatchContextValue = {\n    siteKey: siteKey?.trim() || null,\n    apiBase,\n  };\n\n  if (!value.siteKey) {\n    if (typeof console !== \"undefined\" && console.warn) {\n      console.warn(\n        \"[Dispatch] No siteKey provided. Pass siteKey to DispatchProvider. Hooks will return empty/error state.\"\n      );\n    }\n  }\n\n  return (\n    <DispatchContext.Provider value={value}>\n      {children as React.ReactNode}\n    </DispatchContext.Provider>\n  );\n}\n","const DEFAULT_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport function getApiBase(): string {\n  return DEFAULT_API_BASE;\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport type { Post } from \"./types\";\nimport { useDispatchContext } from \"./context\";\n\nexport type UsePostResult = {\n  post: Post | null;\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function usePost(slug: string | undefined): UsePostResult {\n  const ctx = useDispatchContext();\n  const [post, setPost] = useState<Post | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!slug?.trim()) {\n      setPost(null);\n      setIsLoading(false);\n      setError(undefined);\n      return;\n    }\n\n    if (!ctx?.siteKey) {\n      setPost(null);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setPost(null);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/posts/${encodeURIComponent(slug.trim())}`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (res.status === 404) {\n          setPost(null);\n          setIsLoading(false);\n          return;\n        }\n        if (!res.ok) {\n          setPost(null);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled) return;\n        setPost(data as Post);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setPost(null);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [slug, ctx?.siteKey, ctx?.apiBase]);\n\n  return { post, isLoading, error };\n}\n\nexport type UsePostsResult = {\n  posts: Post[];\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function usePosts(): UsePostsResult {\n  const ctx = useDispatchContext();\n  const [posts, setPosts] = useState<Post[]>([]);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!ctx?.siteKey) {\n      setPosts([]);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setPosts([]);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/posts`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (!res.ok) {\n          setPosts([]);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled) return;\n        setPosts(Array.isArray(data) ? data : []);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setPosts([]);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [ctx?.siteKey, ctx?.apiBase]);\n\n  return { posts, isLoading, error };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/context.tsx","../src/config.ts","../src/hooks.ts","../src/index.ts"],"sourcesContent":["\"use client\";\n\nimport React, { createContext, useContext } from \"react\";\nimport { getApiBase } from \"./config\";\n\ntype DispatchContextValue = {\n  siteKey: string | null;\n  apiBase: string;\n};\n\nconst DispatchContext = createContext<DispatchContextValue | null>(null);\n\nexport function useDispatchContext(): DispatchContextValue | null {\n  return useContext(DispatchContext);\n}\n\ntype DispatchProviderProps = {\n  siteKey?: string | null;\n  apiBase?: string;\n  children?: unknown;\n};\n\nexport function DispatchProvider({\n  siteKey = null,\n  apiBase = getApiBase(),\n  children,\n}: DispatchProviderProps) {\n  const value: DispatchContextValue = {\n    siteKey: siteKey?.trim() || null,\n    apiBase,\n  };\n\n  if (!value.siteKey) {\n    if (typeof console !== \"undefined\" && console.warn) {\n      console.warn(\n        \"[Dispatch] No siteKey provided. Pass siteKey to DispatchProvider. Hooks will return empty/error state.\"\n      );\n    }\n  }\n\n  return (\n    <DispatchContext.Provider value={value}>\n      {children as React.ReactNode}\n    </DispatchContext.Provider>\n  );\n}\n","const DEFAULT_API_BASE = \"https://dispatch-cms.vercel.app\";\n\nexport function getApiBase(): string {\n  return DEFAULT_API_BASE;\n}\n","\"use client\";\n\nimport { useEffect, useState } from \"react\";\nimport type { Entry } from \"./types\";\nimport { useDispatchContext } from \"./context\";\n\nexport type UseEntryResult = {\n  entry: Entry | null;\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function useEntry(collection: string | undefined, slug: string | undefined): UseEntryResult {\n  const ctx = useDispatchContext();\n  const [entry, setEntry] = useState<Entry | null>(null);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!collection?.trim() || !slug?.trim()) {\n      setEntry(null);\n      setIsLoading(false);\n      setError(undefined);\n      return;\n    }\n\n    if (!ctx?.siteKey) {\n      setEntry(null);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setEntry(null);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}/${encodeURIComponent(slug.trim())}`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (res.status === 404) {\n          setEntry(null);\n          setIsLoading(false);\n          return;\n        }\n        if (!res.ok) {\n          setEntry(null);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled || data == null) return;\n        setEntry(data as Entry);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setEntry(null);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [collection, slug, ctx?.siteKey, ctx?.apiBase]);\n\n  return { entry, isLoading, error };\n}\n\nexport type UseEntriesResult = {\n  entries: Entry[];\n  isLoading: boolean;\n  error?: string;\n};\n\nexport function useEntries(collection: string | undefined): UseEntriesResult {\n  const ctx = useDispatchContext();\n  const [entries, setEntries] = useState<Entry[]>([]);\n  const [isLoading, setIsLoading] = useState(true);\n  const [error, setError] = useState<string | undefined>(undefined);\n\n  useEffect(() => {\n    if (!collection?.trim()) {\n      setEntries([]);\n      setIsLoading(false);\n      setError(undefined);\n      return;\n    }\n\n    if (!ctx?.siteKey) {\n      setEntries([]);\n      setIsLoading(false);\n      setError(\"Missing site key\");\n      return;\n    }\n\n    let cancelled = false;\n    setEntries([]);\n    setError(undefined);\n    setIsLoading(true);\n\n    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}`;\n    fetch(url, {\n      headers: { \"X-Site-Key\": ctx.siteKey },\n    })\n      .then((res) => {\n        if (cancelled) return;\n        if (!res.ok) {\n          setEntries([]);\n          setIsLoading(false);\n          setError(\"Failed to load\");\n          return;\n        }\n        return res.json();\n      })\n      .then((data) => {\n        if (cancelled || data == null) return;\n        setEntries(Array.isArray(data) ? data : []);\n        setIsLoading(false);\n      })\n      .catch(() => {\n        if (cancelled) return;\n        setEntries([]);\n        setIsLoading(false);\n        setError(\"Failed to load\");\n      });\n\n    return () => {\n      cancelled = true;\n    };\n  }, [collection, ctx?.siteKey, ctx?.apiBase]);\n\n  return { entries, isLoading, error };\n}\n","export type { Entry } from \"./types\";\nexport { DispatchProvider, useDispatchContext } from \"./context\";\nexport { useEntry, useEntries } from \"./hooks\";\nexport type { UseEntryResult, UseEntriesResult } from \"./hooks\";\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":";;;AAEA,SAAgB,eAAe,kBAAkB;;;ACFjD,IAAM,mBAAmB;AAElB,SAAS,aAAqB;AACnC,SAAO;AACT;;;ADqCI;AA/BJ,IAAM,kBAAkB,cAA2C,IAAI;AAEhE,SAAS,qBAAkD;AAChE,SAAO,WAAW,eAAe;AACnC;AAQO,SAAS,iBAAiB;AAAA,EAC/B,UAAU;AAAA,EACV,UAAU,WAAW;AAAA,EACrB;AACF,GAA0B;AACxB,QAAM,QAA8B;AAAA,IAClC,SAAS,SAAS,KAAK,KAAK;AAAA,IAC5B;AAAA,EACF;AAEA,MAAI,CAAC,MAAM,SAAS;AAClB,QAAI,OAAO,YAAY,eAAe,QAAQ,MAAM;AAClD,cAAQ;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SACE,oBAAC,gBAAgB,UAAhB,EAAyB,OACvB,UACH;AAEJ;;;AE3CA,SAAS,WAAW,gBAAgB;AAU7B,SAAS,SAAS,YAAgC,MAA0C;AACjG,QAAM,MAAM,mBAAmB;AAC/B,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAuB,IAAI;AACrD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA6B,MAAS;AAEhE,YAAU,MAAM;AACd,QAAI,CAAC,YAAY,KAAK,KAAK,CAAC,MAAM,KAAK,GAAG;AACxC,eAAS,IAAI;AACb,mBAAa,KAAK;AAClB,eAAS,MAAS;AAClB;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,SAAS;AACjB,eAAS,IAAI;AACb,mBAAa,KAAK;AAClB,eAAS,kBAAkB;AAC3B;AAAA,IACF;AAEA,QAAI,YAAY;AAChB,aAAS,IAAI;AACb,aAAS,MAAS;AAClB,iBAAa,IAAI;AAEjB,UAAM,MAAM,GAAG,IAAI,OAAO,gBAAgB,mBAAmB,WAAW,KAAK,CAAC,CAAC,IAAI,mBAAmB,KAAK,KAAK,CAAC,CAAC;AAClH,UAAM,KAAK;AAAA,MACT,SAAS,EAAE,cAAc,IAAI,QAAQ;AAAA,IACvC,CAAC,EACE,KAAK,CAAC,QAAQ;AACb,UAAI,UAAW;AACf,UAAI,IAAI,WAAW,KAAK;AACtB,iBAAS,IAAI;AACb,qBAAa,KAAK;AAClB;AAAA,MACF;AACA,UAAI,CAAC,IAAI,IAAI;AACX,iBAAS,IAAI;AACb,qBAAa,KAAK;AAClB,iBAAS,gBAAgB;AACzB;AAAA,MACF;AACA,aAAO,IAAI,KAAK;AAAA,IAClB,CAAC,EACA,KAAK,CAAC,SAAS;AACd,UAAI,aAAa,QAAQ,KAAM;AAC/B,eAAS,IAAa;AACtB,mBAAa,KAAK;AAAA,IACpB,CAAC,EACA,MAAM,MAAM;AACX,UAAI,UAAW;AACf,eAAS,IAAI;AACb,mBAAa,KAAK;AAClB,eAAS,gBAAgB;AAAA,IAC3B,CAAC;AAEH,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,YAAY,MAAM,KAAK,SAAS,KAAK,OAAO,CAAC;AAEjD,SAAO,EAAE,OAAO,WAAW,MAAM;AACnC;AAQO,SAAS,WAAW,YAAkD;AAC3E,QAAM,MAAM,mBAAmB;AAC/B,QAAM,CAAC,SAAS,UAAU,IAAI,SAAkB,CAAC,CAAC;AAClD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAC/C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA6B,MAAS;AAEhE,YAAU,MAAM;AACd,QAAI,CAAC,YAAY,KAAK,GAAG;AACvB,iBAAW,CAAC,CAAC;AACb,mBAAa,KAAK;AAClB,eAAS,MAAS;AAClB;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,SAAS;AACjB,iBAAW,CAAC,CAAC;AACb,mBAAa,KAAK;AAClB,eAAS,kBAAkB;AAC3B;AAAA,IACF;AAEA,QAAI,YAAY;AAChB,eAAW,CAAC,CAAC;AACb,aAAS,MAAS;AAClB,iBAAa,IAAI;AAEjB,UAAM,MAAM,GAAG,IAAI,OAAO,gBAAgB,mBAAmB,WAAW,KAAK,CAAC,CAAC;AAC/E,UAAM,KAAK;AAAA,MACT,SAAS,EAAE,cAAc,IAAI,QAAQ;AAAA,IACvC,CAAC,EACE,KAAK,CAAC,QAAQ;AACb,UAAI,UAAW;AACf,UAAI,CAAC,IAAI,IAAI;AACX,mBAAW,CAAC,CAAC;AACb,qBAAa,KAAK;AAClB,iBAAS,gBAAgB;AACzB;AAAA,MACF;AACA,aAAO,IAAI,KAAK;AAAA,IAClB,CAAC,EACA,KAAK,CAAC,SAAS;AACd,UAAI,aAAa,QAAQ,KAAM;AAC/B,iBAAW,MAAM,QAAQ,IAAI,IAAI,OAAO,CAAC,CAAC;AAC1C,mBAAa,KAAK;AAAA,IACpB,CAAC,EACA,MAAM,MAAM;AACX,UAAI,UAAW;AACf,iBAAW,CAAC,CAAC;AACb,mBAAa,KAAK;AAClB,eAAS,gBAAgB;AAAA,IAC3B,CAAC;AAEH,WAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,EACF,GAAG,CAAC,YAAY,KAAK,SAAS,KAAK,OAAO,CAAC;AAE3C,SAAO,EAAE,SAAS,WAAW,MAAM;AACrC;;;ACvIO,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,7 +1,7 @@
 {
   "name": "@dispatchcms/react",
-  "version": "0.0.6",
-  "description": "React hooks and provider for Dispatch CMS",
+  "version": "0.0.8",
+  "description": "React hooks and provider for Dispatch CMS entries",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",

package/src/hooks.ts

@@ -1,54 +1,54 @@
 "use client";
 
 import { useEffect, useState } from "react";
-import type { Post } from "./types";
+import type { Entry } from "./types";
 import { useDispatchContext } from "./context";
 
-export type UsePostResult = {
-  post: Post | null;
+export type UseEntryResult = {
+  entry: Entry | null;
   isLoading: boolean;
   error?: string;
 };
 
-export function usePost(slug: string | undefined): UsePostResult {
+export function useEntry(collection: string | undefined, slug: string | undefined): UseEntryResult {
   const ctx = useDispatchContext();
-  const [post, setPost] = useState<Post | null>(null);
+  const [entry, setEntry] = useState<Entry | null>(null);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState<string | undefined>(undefined);
 
   useEffect(() => {
-    if (!slug?.trim()) {
-      setPost(null);
+    if (!collection?.trim() || !slug?.trim()) {
+      setEntry(null);
       setIsLoading(false);
       setError(undefined);
       return;
     }
 
     if (!ctx?.siteKey) {
-      setPost(null);
+      setEntry(null);
       setIsLoading(false);
       setError("Missing site key");
       return;
     }
 
     let cancelled = false;
-    setPost(null);
+    setEntry(null);
     setError(undefined);
     setIsLoading(true);
 
-    const url = `${ctx.apiBase}/api/posts/${encodeURIComponent(slug.trim())}`;
+    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}/${encodeURIComponent(slug.trim())}`;
     fetch(url, {
       headers: { "X-Site-Key": ctx.siteKey },
     })
       .then((res) => {
         if (cancelled) return;
         if (res.status === 404) {
-          setPost(null);
+          setEntry(null);
           setIsLoading(false);
           return;
         }
         if (!res.ok) {
-          setPost(null);
+          setEntry(null);
           setIsLoading(false);
           setError("Failed to load");
           return;
@@ -56,13 +56,13 @@ export function usePost(slug: string | undefined): UsePostResult {
         return res.json();
       })
       .then((data) => {
-        if (cancelled) return;
-        setPost(data as Post);
+        if (cancelled || data == null) return;
+        setEntry(data as Entry);
         setIsLoading(false);
       })
       .catch(() => {
         if (cancelled) return;
-        setPost(null);
+        setEntry(null);
         setIsLoading(false);
         setError("Failed to load");
       });
@@ -70,44 +70,51 @@ export function usePost(slug: string | undefined): UsePostResult {
     return () => {
       cancelled = true;
     };
-  }, [slug, ctx?.siteKey, ctx?.apiBase]);
+  }, [collection, slug, ctx?.siteKey, ctx?.apiBase]);
 
-  return { post, isLoading, error };
+  return { entry, isLoading, error };
 }
 
-export type UsePostsResult = {
-  posts: Post[];
+export type UseEntriesResult = {
+  entries: Entry[];
   isLoading: boolean;
   error?: string;
 };
 
-export function usePosts(): UsePostsResult {
+export function useEntries(collection: string | undefined): UseEntriesResult {
   const ctx = useDispatchContext();
-  const [posts, setPosts] = useState<Post[]>([]);
+  const [entries, setEntries] = useState<Entry[]>([]);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState<string | undefined>(undefined);
 
   useEffect(() => {
+    if (!collection?.trim()) {
+      setEntries([]);
+      setIsLoading(false);
+      setError(undefined);
+      return;
+    }
+
     if (!ctx?.siteKey) {
-      setPosts([]);
+      setEntries([]);
       setIsLoading(false);
       setError("Missing site key");
       return;
     }
 
     let cancelled = false;
-    setPosts([]);
+    setEntries([]);
     setError(undefined);
     setIsLoading(true);
 
-    const url = `${ctx.apiBase}/api/posts`;
+    const url = `${ctx.apiBase}/api/content/${encodeURIComponent(collection.trim())}`;
     fetch(url, {
       headers: { "X-Site-Key": ctx.siteKey },
     })
       .then((res) => {
         if (cancelled) return;
         if (!res.ok) {
-          setPosts([]);
+          setEntries([]);
           setIsLoading(false);
           setError("Failed to load");
           return;
@@ -115,13 +122,13 @@ export function usePosts(): UsePostsResult {
         return res.json();
       })
       .then((data) => {
-        if (cancelled) return;
-        setPosts(Array.isArray(data) ? data : []);
+        if (cancelled || data == null) return;
+        setEntries(Array.isArray(data) ? data : []);
         setIsLoading(false);
       })
       .catch(() => {
         if (cancelled) return;
-        setPosts([]);
+        setEntries([]);
         setIsLoading(false);
         setError("Failed to load");
       });
@@ -129,7 +136,7 @@ export function usePosts(): UsePostsResult {
     return () => {
       cancelled = true;
     };
-  }, [ctx?.siteKey, ctx?.apiBase]);
+  }, [collection, ctx?.siteKey, ctx?.apiBase]);
 
-  return { posts, isLoading, error };
+  return { entries, isLoading, error };
 }

package/src/index.ts

@@ -1,4 +1,30 @@
-export type { Post } from "./types";
+export type { Entry } from "./types";
 export { DispatchProvider, useDispatchContext } from "./context";
-export { usePost, usePosts } from "./hooks";
-export type { UsePostResult, UsePostsResult } from "./hooks";
+export { useEntry, useEntries } from "./hooks";
+export type { UseEntryResult, UseEntriesResult } from "./hooks";
+
+// 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/types.ts

@@ -1,13 +1,13 @@
-export type Post = {
+export type Entry = {
   id: string;
   created_at: string;
-  published_at: string;
+  published_at: string | null;
   updated_at: string;
   site_id: string;
+  collection: string;
   title: string;
-  slug: string;
-  content: unknown;
-  excerpt: string | null;
-  featured_image: string | null;
+  slug: string | null;
+  data: Record<string, unknown>;
+  sort_order: number;
   published: boolean;
 };