@dispatchcms/next 0.0.2 → 0.0.3

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @dispatchcms/next@0.0.2 build /Users/jamescalmus/Documents/dispatch/packages/next
+> @dispatchcms/next@0.0.3 build /Users/jamescalmus/Documents/dispatch/packages/next
 > tsup
 
 CLI Building entry: src/index.ts
@@ -11,13 +11,13 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-CJS dist/index.js     3.81 KB
-CJS dist/index.js.map 5.37 KB
-CJS ⚡️ Build success in 4ms
-ESM dist/index.mjs     2.72 KB
-ESM dist/index.mjs.map 5.17 KB
-ESM ⚡️ Build success in 4ms
+CJS dist/index.js     4.25 KB
+CJS dist/index.js.map 6.31 KB
+CJS ⚡️ Build success in 5ms
+ESM dist/index.mjs     3.11 KB
+ESM dist/index.mjs.map 6.06 KB
+ESM ⚡️ Build success in 5ms
 DTS Build start
-DTS ⚡️ Build success in 314ms
-DTS dist/index.d.ts  670.00 B
-DTS dist/index.d.mts 670.00 B
+DTS ⚡️ Build success in 317ms
+DTS dist/index.d.ts  938.00 B
+DTS dist/index.d.mts 938.00 B

package/README.md

@@ -54,6 +54,13 @@ Returns a single published post by slug, or `null` if not found. If the full lis
 - **Returns:** `Promise<Post | null>`
 - **Optional:** pass `siteKey` as the second argument to override the configured site.
 
+### `getPostByPreviewToken(token)`
+
+Returns a single post by its preview token (draft or published). Use this in your app’s **preview** route so editors can open a shareable link and see the post as it will appear. No site key is required; the token is the secret.
+
+- **Returns:** `Promise<Post | null>`
+- **Example:** Implement a route at `/preview` (or `/blog/preview`) that reads `token` from the query and renders the post with the same layout as your live post page (see below).
+
 ## Types
 
 Exportable types:
@@ -106,3 +113,34 @@ export default async function PostPage({ params }: { params: { slug: string } })
 ```
 
 The CMS API only returns **published** posts; drafts are not included.
+
+## Preview route
+
+To support public preview links from the CMS (e.g. `https://yoursite.com/preview?token=xxx`), add a preview page that fetches by token and renders the post:
+
+```tsx
+// app/preview/page.tsx
+import { getPostByPreviewToken } from "@dispatchcms/next";
+import { notFound } from "next/navigation";
+
+export default async function PreviewPage({
+  searchParams,
+}: {
+  searchParams: Promise<{ token?: string }>;
+}) {
+  const { token } = await searchParams;
+  if (!token) notFound();
+  const post = await getPostByPreviewToken(token);
+  if (!post) notFound();
+  return (
+    <article>
+      <p className="text-sm text-muted-foreground">Preview</p>
+      <h1>{post.title}</h1>
+      {post.excerpt && <p>{post.excerpt}</p>}
+      {/* Render post.content the same way as your live post page */}
+    </article>
+  );
+}
+```
+
+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=...`.

package/dist/index.d.mts

@@ -20,5 +20,10 @@ declare function getConfig(): {
 };
 declare function getPosts(siteKey?: string): Promise<Post[]>;
 declare function getPost(slug: string, siteKey?: string): Promise<Post | null>;
+/**
+ * Fetch a single post by its preview token (for preview/draft pages).
+ * No site key required. Use this in your app's preview route (e.g. /preview?token=...).
+ */
+declare function getPostByPreviewToken(token: string): Promise<Post | null>;
 
-export { type DispatchConfig, type Post, getConfig, getPost, getPosts, initDispatch };
+export { type DispatchConfig, type Post, getConfig, getPost, getPostByPreviewToken, getPosts, initDispatch };

package/dist/index.d.ts

@@ -20,5 +20,10 @@ declare function getConfig(): {
 };
 declare function getPosts(siteKey?: string): Promise<Post[]>;
 declare function getPost(slug: string, siteKey?: string): Promise<Post | null>;
+/**
+ * Fetch a single post by its preview token (for preview/draft pages).
+ * No site key required. Use this in your app's preview route (e.g. /preview?token=...).
+ */
+declare function getPostByPreviewToken(token: string): Promise<Post | null>;
 
-export { type DispatchConfig, type Post, getConfig, getPost, getPosts, initDispatch };
+export { type DispatchConfig, type Post, getConfig, getPost, getPostByPreviewToken, getPosts, initDispatch };

package/dist/index.js

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   getConfig: () => getConfig,
   getPost: () => getPost,
+  getPostByPreviewToken: () => getPostByPreviewToken,
   getPosts: () => getPosts,
   initDispatch: () => initDispatch
 });
@@ -106,10 +107,21 @@ async function getPost(slug, siteKey) {
   postBySlugBySiteKey.get(resolvedKey).set(slug, post);
   return post;
 }
+async function getPostByPreviewToken(token) {
+  if (!token?.trim()) return null;
+  const url = `${DISPATCH_API_BASE}/api/preview?token=${encodeURIComponent(token.trim())}`;
+  const res = await fetch(url);
+  if (res.status === 404) return null;
+  if (!res.ok) {
+    throw new Error(`Failed to fetch preview: ${res.status} ${res.statusText}`);
+  }
+  return await res.json();
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getConfig,
   getPost,
+  getPostByPreviewToken,
   getPosts,
   initDispatch
 });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export type { Post, DispatchConfig } from \"./client\";\nexport { initDispatch, getConfig, getPosts, getPost } from \"./client\";\n","export type Post = {\n  id: string;\n  created_at: string;\n  published_at: string;\n  updated_at: string;\n  site_id: string;\n  title: string;\n  slug: string;\n  content: unknown;\n  excerpt: string | null;\n  featured_image: string | null;\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\nconst allPostsBySiteKey = new Map<string, Post[]>();\nconst postBySlugBySiteKey = new Map<string, Map<string, Post>>();\nconst fullListFetchedForSiteKey = new Set<string>();\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 getPosts(siteKey?: string): Promise<Post[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const cached = allPostsBySiteKey.get(resolvedKey);\n  if (cached !== undefined) {\n    return cached;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts`;\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 posts: ${res.status} ${res.statusText}`);\n  }\n  const posts = (await res.json()) as Post[];\n  allPostsBySiteKey.set(resolvedKey, posts);\n  fullListFetchedForSiteKey.add(resolvedKey);\n  const bySlug = new Map<string, Post>();\n  for (const post of posts) {\n    bySlug.set(post.slug, post);\n  }\n  postBySlugBySiteKey.set(resolvedKey, bySlug);\n  return posts;\n}\n\nexport async function getPost(slug: string, siteKey?: string): Promise<Post | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  if (fullListFetchedForSiteKey.has(resolvedKey)) {\n    const list = allPostsBySiteKey.get(resolvedKey);\n    if (list) {\n      const post = list.find((p) => p.slug === slug);\n      return post ?? null;\n    }\n  }\n  const bySlug = postBySlugBySiteKey.get(resolvedKey);\n  const cachedPost = bySlug?.get(slug);\n  if (cachedPost !== undefined) {\n    return cachedPost;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts/${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 post: ${res.status} ${res.statusText}`);\n  }\n  const post = (await res.json()) as Post;\n  if (!postBySlugBySiteKey.has(resolvedKey)) {\n    postBySlugBySiteKey.set(resolvedKey, new Map());\n  }\n  postBySlugBySiteKey.get(resolvedKey)!.set(slug, post);\n  return post;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACcA,IAAM,oBAAoB;AAM1B,IAAI,SAAgC;AAEpC,IAAM,oBAAoB,oBAAI,IAAoB;AAClD,IAAM,sBAAsB,oBAAI,IAA+B;AAC/D,IAAM,4BAA4B,oBAAI,IAAY;AAE3C,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,SAAS,SAAmC;AAChE,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,SAAS,kBAAkB,IAAI,WAAW;AAChD,MAAI,WAAW,QAAW;AACxB,WAAO;AAAA,EACT;AACA,QAAM,MAAM,GAAG,iBAAiB;AAChC,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,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC1E;AACA,QAAM,QAAS,MAAM,IAAI,KAAK;AAC9B,oBAAkB,IAAI,aAAa,KAAK;AACxC,4BAA0B,IAAI,WAAW;AACzC,QAAM,SAAS,oBAAI,IAAkB;AACrC,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,KAAK,MAAM,IAAI;AAAA,EAC5B;AACA,sBAAoB,IAAI,aAAa,MAAM;AAC3C,SAAO;AACT;AAEA,eAAsB,QAAQ,MAAc,SAAwC;AAClF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,MAAI,0BAA0B,IAAI,WAAW,GAAG;AAC9C,UAAM,OAAO,kBAAkB,IAAI,WAAW;AAC9C,QAAI,MAAM;AACR,YAAMA,QAAO,KAAK,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AAC7C,aAAOA,SAAQ;AAAA,IACjB;AAAA,EACF;AACA,QAAM,SAAS,oBAAoB,IAAI,WAAW;AAClD,QAAM,aAAa,QAAQ,IAAI,IAAI;AACnC,MAAI,eAAe,QAAW;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,MAAM,GAAG,iBAAiB,cAAc,mBAAmB,IAAI,CAAC;AACtE,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,yBAAyB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EACzE;AACA,QAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,MAAI,CAAC,oBAAoB,IAAI,WAAW,GAAG;AACzC,wBAAoB,IAAI,aAAa,oBAAI,IAAI,CAAC;AAAA,EAChD;AACA,sBAAoB,IAAI,WAAW,EAAG,IAAI,MAAM,IAAI;AACpD,SAAO;AACT;","names":["post"]}
+{"version":3,"sources":["../src/index.ts","../src/client.ts"],"sourcesContent":["export type { Post, DispatchConfig } from \"./client\";\nexport {\n  initDispatch,\n  getConfig,\n  getPosts,\n  getPost,\n  getPostByPreviewToken,\n} from \"./client\";\n","export type Post = {\n  id: string;\n  created_at: string;\n  published_at: string;\n  updated_at: string;\n  site_id: string;\n  title: string;\n  slug: string;\n  content: unknown;\n  excerpt: string | null;\n  featured_image: string | null;\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\nconst allPostsBySiteKey = new Map<string, Post[]>();\nconst postBySlugBySiteKey = new Map<string, Map<string, Post>>();\nconst fullListFetchedForSiteKey = new Set<string>();\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 getPosts(siteKey?: string): Promise<Post[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const cached = allPostsBySiteKey.get(resolvedKey);\n  if (cached !== undefined) {\n    return cached;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts`;\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 posts: ${res.status} ${res.statusText}`);\n  }\n  const posts = (await res.json()) as Post[];\n  allPostsBySiteKey.set(resolvedKey, posts);\n  fullListFetchedForSiteKey.add(resolvedKey);\n  const bySlug = new Map<string, Post>();\n  for (const post of posts) {\n    bySlug.set(post.slug, post);\n  }\n  postBySlugBySiteKey.set(resolvedKey, bySlug);\n  return posts;\n}\n\nexport async function getPost(slug: string, siteKey?: string): Promise<Post | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  if (fullListFetchedForSiteKey.has(resolvedKey)) {\n    const list = allPostsBySiteKey.get(resolvedKey);\n    if (list) {\n      const post = list.find((p) => p.slug === slug);\n      return post ?? null;\n    }\n  }\n  const bySlug = postBySlugBySiteKey.get(resolvedKey);\n  const cachedPost = bySlug?.get(slug);\n  if (cachedPost !== undefined) {\n    return cachedPost;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts/${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 post: ${res.status} ${res.statusText}`);\n  }\n  const post = (await res.json()) as Post;\n  if (!postBySlugBySiteKey.has(resolvedKey)) {\n    postBySlugBySiteKey.set(resolvedKey, new Map());\n  }\n  postBySlugBySiteKey.get(resolvedKey)!.set(slug, post);\n  return post;\n}\n\n/**\n * Fetch a single post by its preview token (for preview/draft pages).\n * No site key required. Use this in your app's preview route (e.g. /preview?token=...).\n */\nexport async function getPostByPreviewToken(token: string): Promise<Post | 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 Post;\n}\n"],"mappings":"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","names":["post"]}

package/dist/index.mjs

@@ -77,9 +77,20 @@ async function getPost(slug, siteKey) {
   postBySlugBySiteKey.get(resolvedKey).set(slug, post);
   return post;
 }
+async function getPostByPreviewToken(token) {
+  if (!token?.trim()) return null;
+  const url = `${DISPATCH_API_BASE}/api/preview?token=${encodeURIComponent(token.trim())}`;
+  const res = await fetch(url);
+  if (res.status === 404) return null;
+  if (!res.ok) {
+    throw new Error(`Failed to fetch preview: ${res.status} ${res.statusText}`);
+  }
+  return await res.json();
+}
 export {
   getConfig,
   getPost,
+  getPostByPreviewToken,
   getPosts,
   initDispatch
 };

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"sourcesContent":["export type Post = {\n  id: string;\n  created_at: string;\n  published_at: string;\n  updated_at: string;\n  site_id: string;\n  title: string;\n  slug: string;\n  content: unknown;\n  excerpt: string | null;\n  featured_image: string | null;\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\nconst allPostsBySiteKey = new Map<string, Post[]>();\nconst postBySlugBySiteKey = new Map<string, Map<string, Post>>();\nconst fullListFetchedForSiteKey = new Set<string>();\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 getPosts(siteKey?: string): Promise<Post[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const cached = allPostsBySiteKey.get(resolvedKey);\n  if (cached !== undefined) {\n    return cached;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts`;\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 posts: ${res.status} ${res.statusText}`);\n  }\n  const posts = (await res.json()) as Post[];\n  allPostsBySiteKey.set(resolvedKey, posts);\n  fullListFetchedForSiteKey.add(resolvedKey);\n  const bySlug = new Map<string, Post>();\n  for (const post of posts) {\n    bySlug.set(post.slug, post);\n  }\n  postBySlugBySiteKey.set(resolvedKey, bySlug);\n  return posts;\n}\n\nexport async function getPost(slug: string, siteKey?: string): Promise<Post | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  if (fullListFetchedForSiteKey.has(resolvedKey)) {\n    const list = allPostsBySiteKey.get(resolvedKey);\n    if (list) {\n      const post = list.find((p) => p.slug === slug);\n      return post ?? null;\n    }\n  }\n  const bySlug = postBySlugBySiteKey.get(resolvedKey);\n  const cachedPost = bySlug?.get(slug);\n  if (cachedPost !== undefined) {\n    return cachedPost;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts/${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 post: ${res.status} ${res.statusText}`);\n  }\n  const post = (await res.json()) as Post;\n  if (!postBySlugBySiteKey.has(resolvedKey)) {\n    postBySlugBySiteKey.set(resolvedKey, new Map());\n  }\n  postBySlugBySiteKey.get(resolvedKey)!.set(slug, post);\n  return post;\n}\n"],"mappings":";AAcA,IAAM,oBAAoB;AAM1B,IAAI,SAAgC;AAEpC,IAAM,oBAAoB,oBAAI,IAAoB;AAClD,IAAM,sBAAsB,oBAAI,IAA+B;AAC/D,IAAM,4BAA4B,oBAAI,IAAY;AAE3C,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,SAAS,SAAmC;AAChE,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,QAAM,SAAS,kBAAkB,IAAI,WAAW;AAChD,MAAI,WAAW,QAAW;AACxB,WAAO;AAAA,EACT;AACA,QAAM,MAAM,GAAG,iBAAiB;AAChC,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,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EAC1E;AACA,QAAM,QAAS,MAAM,IAAI,KAAK;AAC9B,oBAAkB,IAAI,aAAa,KAAK;AACxC,4BAA0B,IAAI,WAAW;AACzC,QAAM,SAAS,oBAAI,IAAkB;AACrC,aAAW,QAAQ,OAAO;AACxB,WAAO,IAAI,KAAK,MAAM,IAAI;AAAA,EAC5B;AACA,sBAAoB,IAAI,aAAa,MAAM;AAC3C,SAAO;AACT;AAEA,eAAsB,QAAQ,MAAc,SAAwC;AAClF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,MAAI,0BAA0B,IAAI,WAAW,GAAG;AAC9C,UAAM,OAAO,kBAAkB,IAAI,WAAW;AAC9C,QAAI,MAAM;AACR,YAAMA,QAAO,KAAK,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI;AAC7C,aAAOA,SAAQ;AAAA,IACjB;AAAA,EACF;AACA,QAAM,SAAS,oBAAoB,IAAI,WAAW;AAClD,QAAM,aAAa,QAAQ,IAAI,IAAI;AACnC,MAAI,eAAe,QAAW;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,MAAM,GAAG,iBAAiB,cAAc,mBAAmB,IAAI,CAAC;AACtE,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,yBAAyB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,EACzE;AACA,QAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,MAAI,CAAC,oBAAoB,IAAI,WAAW,GAAG;AACzC,wBAAoB,IAAI,aAAa,oBAAI,IAAI,CAAC;AAAA,EAChD;AACA,sBAAoB,IAAI,WAAW,EAAG,IAAI,MAAM,IAAI;AACpD,SAAO;AACT;","names":["post"]}
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["export type Post = {\n  id: string;\n  created_at: string;\n  published_at: string;\n  updated_at: string;\n  site_id: string;\n  title: string;\n  slug: string;\n  content: unknown;\n  excerpt: string | null;\n  featured_image: string | null;\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\nconst allPostsBySiteKey = new Map<string, Post[]>();\nconst postBySlugBySiteKey = new Map<string, Map<string, Post>>();\nconst fullListFetchedForSiteKey = new Set<string>();\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 getPosts(siteKey?: string): Promise<Post[]> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  const cached = allPostsBySiteKey.get(resolvedKey);\n  if (cached !== undefined) {\n    return cached;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts`;\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 posts: ${res.status} ${res.statusText}`);\n  }\n  const posts = (await res.json()) as Post[];\n  allPostsBySiteKey.set(resolvedKey, posts);\n  fullListFetchedForSiteKey.add(resolvedKey);\n  const bySlug = new Map<string, Post>();\n  for (const post of posts) {\n    bySlug.set(post.slug, post);\n  }\n  postBySlugBySiteKey.set(resolvedKey, bySlug);\n  return posts;\n}\n\nexport async function getPost(slug: string, siteKey?: string): Promise<Post | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\n  if (fullListFetchedForSiteKey.has(resolvedKey)) {\n    const list = allPostsBySiteKey.get(resolvedKey);\n    if (list) {\n      const post = list.find((p) => p.slug === slug);\n      return post ?? null;\n    }\n  }\n  const bySlug = postBySlugBySiteKey.get(resolvedKey);\n  const cachedPost = bySlug?.get(slug);\n  if (cachedPost !== undefined) {\n    return cachedPost;\n  }\n  const url = `${DISPATCH_API_BASE}/api/posts/${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 post: ${res.status} ${res.statusText}`);\n  }\n  const post = (await res.json()) as Post;\n  if (!postBySlugBySiteKey.has(resolvedKey)) {\n    postBySlugBySiteKey.set(resolvedKey, new Map());\n  }\n  postBySlugBySiteKey.get(resolvedKey)!.set(slug, post);\n  return post;\n}\n\n/**\n * Fetch a single post by its preview token (for preview/draft pages).\n * No site key required. Use this in your app's preview route (e.g. /preview?token=...).\n */\nexport async function getPostByPreviewToken(token: string): Promise<Post | 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 Post;\n}\n"],"mappings":"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","names":["post"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dispatchcms/next",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Fetch published posts from a Dispatch CMS in Next.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/client.ts

@@ -100,3 +100,18 @@ export async function getPost(slug: string, siteKey?: string): Promise<Post | nu
   postBySlugBySiteKey.get(resolvedKey)!.set(slug, post);
   return post;
 }
+
+/**
+ * Fetch a single post by its preview token (for preview/draft pages).
+ * No site key required. Use this in your app's preview route (e.g. /preview?token=...).
+ */
+export async function getPostByPreviewToken(token: string): Promise<Post | null> {
+  if (!token?.trim()) return null;
+  const url = `${DISPATCH_API_BASE}/api/preview?token=${encodeURIComponent(token.trim())}`;
+  const res = await fetch(url);
+  if (res.status === 404) return null;
+  if (!res.ok) {
+    throw new Error(`Failed to fetch preview: ${res.status} ${res.statusText}`);
+  }
+  return (await res.json()) as Post;
+}

package/src/index.ts

@@ -1,2 +1,8 @@
 export type { Post, DispatchConfig } from "./client";
-export { initDispatch, getConfig, getPosts, getPost } from "./client";
+export {
+  initDispatch,
+  getConfig,
+  getPosts,
+  getPost,
+  getPostByPreviewToken,
+} from "./client";