@dispatchcms/next 0.0.1 → 0.0.3

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @dispatchcms/next@0.0.1 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
-ESM dist/index.mjs     1.63 KB
-ESM dist/index.mjs.map 3.30 KB
-ESM ⚡️ Build success in 11ms
-CJS dist/index.js     2.72 KB
-CJS dist/index.js.map 3.50 KB
-CJS ⚡️ Build success in 11ms
+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 424ms
-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

@@ -34,22 +34,33 @@ initDispatch({
 
 You can omit `initDispatch` entirely if `NEXT_PUBLIC_DISPATCH_SITE_KEY` is set; the package will use it automatically.
 
+## Caching
+
+The client caches responses in memory so that repeated requests (e.g. when navigating around a site) do not trigger unnecessary API calls. If you have already fetched all posts with `getPosts()`, single-post lookups with `getPost(slug)` are served from that cache when the slug is in the list, so no extra request is made.
+
 ## API
 
 ### `getPosts(siteKey?)`
 
-Returns all published posts for the site.
+Returns all published posts for the site. Results are cached per site key.
 
 - **Returns:** `Promise<Post[]>`
 - **Optional:** pass `siteKey` to override the configured site for this call.
 
 ### `getPost(slug, siteKey?)`
 
-Returns a single published post by slug, or `null` if not found.
+Returns a single published post by slug, or `null` if not found. If the full list was already loaded via `getPosts()` for the same site, the post is returned from cache when present; otherwise a single-post request is made and cached.
 
 - **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:
@@ -102,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
 });
@@ -30,6 +31,9 @@ module.exports = __toCommonJS(index_exports);
 // src/client.ts
 var DISPATCH_API_BASE = "https://dispatch-cms.vercel.app";
 var config = null;
+var allPostsBySiteKey = /* @__PURE__ */ new Map();
+var postBySlugBySiteKey = /* @__PURE__ */ new Map();
+var fullListFetchedForSiteKey = /* @__PURE__ */ new Set();
 function initDispatch(options) {
   config = { siteKey: options.siteKey };
 }
@@ -44,6 +48,10 @@ function getConfig() {
 async function getPosts(siteKey) {
   const { siteKey: key } = getConfig();
   const resolvedKey = siteKey ?? key;
+  const cached = allPostsBySiteKey.get(resolvedKey);
+  if (cached !== void 0) {
+    return cached;
+  }
   const url = `${DISPATCH_API_BASE}/api/posts`;
   const res = await fetch(url, {
     headers: { "X-Site-Key": resolvedKey }
@@ -54,11 +62,31 @@ async function getPosts(siteKey) {
     }
     throw new Error(`Failed to fetch posts: ${res.status} ${res.statusText}`);
   }
-  return res.json();
+  const posts = await res.json();
+  allPostsBySiteKey.set(resolvedKey, posts);
+  fullListFetchedForSiteKey.add(resolvedKey);
+  const bySlug = /* @__PURE__ */ new Map();
+  for (const post of posts) {
+    bySlug.set(post.slug, post);
+  }
+  postBySlugBySiteKey.set(resolvedKey, bySlug);
+  return posts;
 }
 async function getPost(slug, siteKey) {
   const { siteKey: key } = getConfig();
   const resolvedKey = siteKey ?? key;
+  if (fullListFetchedForSiteKey.has(resolvedKey)) {
+    const list = allPostsBySiteKey.get(resolvedKey);
+    if (list) {
+      const post2 = list.find((p) => p.slug === slug);
+      return post2 ?? null;
+    }
+  }
+  const bySlug = postBySlugBySiteKey.get(resolvedKey);
+  const cachedPost = bySlug?.get(slug);
+  if (cachedPost !== void 0) {
+    return cachedPost;
+  }
   const url = `${DISPATCH_API_BASE}/api/posts/${encodeURIComponent(slug)}`;
   const res = await fetch(url, {
     headers: { "X-Site-Key": resolvedKey }
@@ -72,12 +100,28 @@ async function getPost(slug, siteKey) {
     }
     throw new Error(`Failed to fetch post: ${res.status} ${res.statusText}`);
   }
-  return res.json();
+  const post = await res.json();
+  if (!postBySlugBySiteKey.has(resolvedKey)) {
+    postBySlugBySiteKey.set(resolvedKey, /* @__PURE__ */ new Map());
+  }
+  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\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 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  return res.json() as Promise<Post[]>;\n}\n\nexport async function getPost(slug: string, siteKey?: string): Promise<Post | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\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  return res.json() as Promise<Post>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;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,SAAS,SAAmC;AAChE,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,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,SAAO,IAAI,KAAK;AAClB;AAEA,eAAsB,QAAQ,MAAc,SAAwC;AAClF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,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,SAAO,IAAI,KAAK;AAClB;","names":[]}
+{"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

@@ -1,6 +1,9 @@
 // src/client.ts
 var DISPATCH_API_BASE = "https://dispatch-cms.vercel.app";
 var config = null;
+var allPostsBySiteKey = /* @__PURE__ */ new Map();
+var postBySlugBySiteKey = /* @__PURE__ */ new Map();
+var fullListFetchedForSiteKey = /* @__PURE__ */ new Set();
 function initDispatch(options) {
   config = { siteKey: options.siteKey };
 }
@@ -15,6 +18,10 @@ function getConfig() {
 async function getPosts(siteKey) {
   const { siteKey: key } = getConfig();
   const resolvedKey = siteKey ?? key;
+  const cached = allPostsBySiteKey.get(resolvedKey);
+  if (cached !== void 0) {
+    return cached;
+  }
   const url = `${DISPATCH_API_BASE}/api/posts`;
   const res = await fetch(url, {
     headers: { "X-Site-Key": resolvedKey }
@@ -25,11 +32,31 @@ async function getPosts(siteKey) {
     }
     throw new Error(`Failed to fetch posts: ${res.status} ${res.statusText}`);
   }
-  return res.json();
+  const posts = await res.json();
+  allPostsBySiteKey.set(resolvedKey, posts);
+  fullListFetchedForSiteKey.add(resolvedKey);
+  const bySlug = /* @__PURE__ */ new Map();
+  for (const post of posts) {
+    bySlug.set(post.slug, post);
+  }
+  postBySlugBySiteKey.set(resolvedKey, bySlug);
+  return posts;
 }
 async function getPost(slug, siteKey) {
   const { siteKey: key } = getConfig();
   const resolvedKey = siteKey ?? key;
+  if (fullListFetchedForSiteKey.has(resolvedKey)) {
+    const list = allPostsBySiteKey.get(resolvedKey);
+    if (list) {
+      const post2 = list.find((p) => p.slug === slug);
+      return post2 ?? null;
+    }
+  }
+  const bySlug = postBySlugBySiteKey.get(resolvedKey);
+  const cachedPost = bySlug?.get(slug);
+  if (cachedPost !== void 0) {
+    return cachedPost;
+  }
   const url = `${DISPATCH_API_BASE}/api/posts/${encodeURIComponent(slug)}`;
   const res = await fetch(url, {
     headers: { "X-Site-Key": resolvedKey }
@@ -43,11 +70,27 @@ async function getPost(slug, siteKey) {
     }
     throw new Error(`Failed to fetch post: ${res.status} ${res.statusText}`);
   }
-  return res.json();
+  const post = await res.json();
+  if (!postBySlugBySiteKey.has(resolvedKey)) {
+    postBySlugBySiteKey.set(resolvedKey, /* @__PURE__ */ new Map());
+  }
+  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\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 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  return res.json() as Promise<Post[]>;\n}\n\nexport async function getPost(slug: string, siteKey?: string): Promise<Post | null> {\n  const { siteKey: key } = getConfig();\n  const resolvedKey = siteKey ?? key;\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  return res.json() as Promise<Post>;\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,SAAS,SAAmC;AAChE,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,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,SAAO,IAAI,KAAK;AAClB;AAEA,eAAsB,QAAQ,MAAc,SAAwC;AAClF,QAAM,EAAE,SAAS,IAAI,IAAI,UAAU;AACnC,QAAM,cAAc,WAAW;AAC/B,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,SAAO,IAAI,KAAK;AAClB;","names":[]}
+{"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.1",
+  "version": "0.0.3",
   "description": "Fetch published posts from a Dispatch CMS in Next.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -14,7 +14,8 @@
   },
   "scripts": {
     "build": "tsup",
-    "test": "tsx test/getPage.test.ts"
+    "test": "tsx test/client.cache.test.ts",
+    "test:manual": "tsx test/getPage.test.ts"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",

package/src/client.ts

@@ -20,6 +20,10 @@ export type DispatchConfig = {
 
 let config: DispatchConfig | null = null;
 
+const allPostsBySiteKey = new Map<string, Post[]>();
+const postBySlugBySiteKey = new Map<string, Map<string, Post>>();
+const fullListFetchedForSiteKey = new Set<string>();
+
 export function initDispatch(options: DispatchConfig): void {
   config = { siteKey: options.siteKey };
 }
@@ -36,6 +40,10 @@ export function getConfig(): { siteKey: string } {
 export async function getPosts(siteKey?: string): Promise<Post[]> {
   const { siteKey: key } = getConfig();
   const resolvedKey = siteKey ?? key;
+  const cached = allPostsBySiteKey.get(resolvedKey);
+  if (cached !== undefined) {
+    return cached;
+  }
   const url = `${DISPATCH_API_BASE}/api/posts`;
   const res = await fetch(url, {
     headers: { "X-Site-Key": resolvedKey },
@@ -46,12 +54,32 @@ export async function getPosts(siteKey?: string): Promise<Post[]> {
     }
     throw new Error(`Failed to fetch posts: ${res.status} ${res.statusText}`);
   }
-  return res.json() as Promise<Post[]>;
+  const posts = (await res.json()) as Post[];
+  allPostsBySiteKey.set(resolvedKey, posts);
+  fullListFetchedForSiteKey.add(resolvedKey);
+  const bySlug = new Map<string, Post>();
+  for (const post of posts) {
+    bySlug.set(post.slug, post);
+  }
+  postBySlugBySiteKey.set(resolvedKey, bySlug);
+  return posts;
 }
 
 export async function getPost(slug: string, siteKey?: string): Promise<Post | null> {
   const { siteKey: key } = getConfig();
   const resolvedKey = siteKey ?? key;
+  if (fullListFetchedForSiteKey.has(resolvedKey)) {
+    const list = allPostsBySiteKey.get(resolvedKey);
+    if (list) {
+      const post = list.find((p) => p.slug === slug);
+      return post ?? null;
+    }
+  }
+  const bySlug = postBySlugBySiteKey.get(resolvedKey);
+  const cachedPost = bySlug?.get(slug);
+  if (cachedPost !== undefined) {
+    return cachedPost;
+  }
   const url = `${DISPATCH_API_BASE}/api/posts/${encodeURIComponent(slug)}`;
   const res = await fetch(url, {
     headers: { "X-Site-Key": resolvedKey },
@@ -65,5 +93,25 @@ export async function getPost(slug: string, siteKey?: string): Promise<Post | nu
     }
     throw new Error(`Failed to fetch post: ${res.status} ${res.statusText}`);
   }
-  return res.json() as Promise<Post>;
+  const post = (await res.json()) as Post;
+  if (!postBySlugBySiteKey.has(resolvedKey)) {
+    postBySlugBySiteKey.set(resolvedKey, new Map());
+  }
+  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";

package/test/client.cache.test.ts

@@ -0,0 +1,113 @@
+import { initDispatch, getPosts, getPost } from "../src/index";
+
+const mockPost = (slug: string, title: string) => ({
+  id: `id-${slug}`,
+  created_at: "",
+  published_at: "",
+  updated_at: "",
+  site_id: "",
+  title,
+  slug,
+  content: null,
+  excerpt: null,
+  featured_image: null,
+  published: true,
+});
+
+type FetchCall = { url: string };
+const fetchCalls: FetchCall[] = [];
+let listResponse: ReturnType<typeof mockPost>[] = [];
+let singleResponse: ReturnType<typeof mockPost> | null = null;
+let singleStatus = 200;
+
+function mockFetch(url: string, options?: RequestInit): Promise<Response> {
+  fetchCalls.push({ url });
+  const u = new URL(url);
+  if (u.pathname === "/api/posts") {
+    return Promise.resolve({
+      ok: true,
+      status: 200,
+      json: () => Promise.resolve(listResponse),
+    } as Response);
+  }
+  const slugMatch = u.pathname.match(/^\/api\/posts\/(.+)$/);
+  if (slugMatch) {
+    const slug = decodeURIComponent(slugMatch[1]);
+    if (singleStatus === 404) {
+      return Promise.resolve({
+        ok: false,
+        status: 404,
+      } as Response);
+    }
+    return Promise.resolve({
+      ok: true,
+      status: 200,
+      json: () => Promise.resolve(singleResponse ?? mockPost(slug, "Single")),
+    } as Response);
+  }
+  return Promise.reject(new Error(`Unexpected URL: ${url}`));
+}
+
+function assert(condition: boolean, message: string): void {
+  if (!condition) {
+    throw new Error(`Assertion failed: ${message}`);
+  }
+}
+
+async function run(): Promise<void> {
+  const originalFetch = globalThis.fetch;
+  globalThis.fetch = mockFetch as typeof fetch;
+
+  initDispatch({ siteKey: "pk_test" });
+
+  try {
+    // Test 1: Second getPosts() with same siteKey does not call fetch
+    fetchCalls.length = 0;
+    listResponse = [mockPost("a", "Post A"), mockPost("b", "Post B")];
+    const list1 = await getPosts("pk_cache1");
+    const list2 = await getPosts("pk_cache1");
+    assert(fetchCalls.length === 1, "getPosts should be fetched once, then served from cache");
+    assert(list1.length === 2 && list2.length === 2, "both calls return same list");
+    assert(list1[0].slug === "a" && list2[0].slug === "a", "content matches");
+
+    // Test 2: After getPosts(), getPost(slug) for slug in list does not call fetch
+    fetchCalls.length = 0;
+    listResponse = [mockPost("my-slug", "My Post")];
+    await getPosts("pk_cache2");
+    const post = await getPost("my-slug", "pk_cache2");
+    assert(fetchCalls.length === 1, "only getPosts should trigger fetch, getPost uses cache");
+    assert(post !== null && post.slug === "my-slug" && post.title === "My Post", "getPost returns correct post from list");
+
+    // Test 3: After getPosts(), getPost(slug) for slug not in list returns null without fetch
+    fetchCalls.length = 0;
+    listResponse = [mockPost("other", "Other")];
+    await getPosts("pk_cache3");
+    const missing = await getPost("nonexistent", "pk_cache3");
+    assert(fetchCalls.length === 1, "getPost(nonexistent) should not fetch when full list is cached");
+    assert(missing === null, "getPost returns null for missing slug");
+
+    // Test 4: getPost(slug) first triggers one fetch; then getPosts() triggers one fetch; then getPost(slug) uses cache
+    fetchCalls.length = 0;
+    listResponse = [];
+    singleResponse = mockPost("first", "First Post");
+    const singleFirst = await getPost("first", "pk_cache4");
+    assert(fetchCalls.length === 1 && singleFirst?.slug === "first", "first getPost fetches");
+    listResponse = [mockPost("first", "First Post")];
+    await getPosts("pk_cache4");
+    assert(fetchCalls.length === 2, "getPosts triggers second fetch");
+    const singleCached = await getPost("first", "pk_cache4");
+    assert(fetchCalls.length === 2, "getPost after getPosts does not fetch again");
+    assert(singleCached !== null && singleCached.slug === "first", "getPost returns post from list cache");
+  } finally {
+    globalThis.fetch = originalFetch;
+  }
+}
+
+run()
+  .then(() => {
+    console.log("All cache tests passed.");
+  })
+  .catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });