@dispatchcms/next 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,23 @@
+
+
+> @dispatchcms/next@0.0.1 build /Users/jamescalmus/Documents/dispatch/packages/next
+> tsup
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/jamescalmus/Documents/dispatch/packages/next/tsup.config.ts
+CLI Target: es2020
+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
+DTS Build start
+DTS ⚡️ Build success in 424ms
+DTS dist/index.d.ts  670.00 B
+DTS dist/index.d.mts 670.00 B

package/README.md

@@ -0,0 +1,104 @@
+# @dispatchcms/next
+
+Fetch published posts from a [Dispatch](https://github.com/dispatch-cms/dispatch) CMS in your Next.js app.
+
+## Install
+
+```bash
+npm install @dispatchcms/next
+# or
+pnpm add @dispatchcms/next
+# or
+yarn add @dispatchcms/next
+```
+
+## Environment variables
+
+Set this in your Next.js project (e.g. `.env.local`) if you don't call `initDispatch`:
+
+| Variable | Description |
+|----------|-------------|
+| `NEXT_PUBLIC_DISPATCH_SITE_KEY` | Your site key (e.g. `pk_xxxx`). Required if you don't call `initDispatch`. |
+
+## Setup
+
+Call `initDispatch` once so the client knows your site key. For example in your root layout or before any fetch:
+
+```ts
+import { initDispatch } from "@dispatchcms/next";
+
+initDispatch({
+  siteKey: process.env.NEXT_PUBLIC_DISPATCH_SITE_KEY!,
+});
+```
+
+You can omit `initDispatch` entirely if `NEXT_PUBLIC_DISPATCH_SITE_KEY` is set; the package will use it automatically.
+
+## API
+
+### `getPosts(siteKey?)`
+
+Returns all published posts for the site.
+
+- **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:** `Promise<Post | null>`
+- **Optional:** pass `siteKey` as the second argument to override the configured site.
+
+## Types
+
+Exportable types:
+
+- **`Post`** – A post from the CMS. Main fields: `id`, `title`, `slug`, `content` (TipTap JSON), `excerpt`, `featured_image`, `published`, `published_at`, `created_at`, `updated_at`, `site_id`.
+- **`DispatchConfig`** – Options for `initDispatch`: `{ siteKey: string }`.
+
+Use your editor’s type hints or the generated `.d.ts` for the full shape.
+
+## Example (Next.js App Router)
+
+**List posts (Server Component):**
+
+```tsx
+// app/blog/page.tsx
+import { getPosts } from "@dispatchcms/next";
+
+export default async function BlogPage() {
+  const posts = await getPosts();
+  return (
+    <ul>
+      {posts.map((post) => (
+        <li key={post.id}>
+          <a href={`/blog/${post.slug}`}>{post.title}</a>
+        </li>
+      ))}
+    </ul>
+  );
+}
+```
+
+**Single post (Server Component):**
+
+```tsx
+// app/blog/[slug]/page.tsx
+import { getPost } from "@dispatchcms/next";
+import { notFound } from "next/navigation";
+
+export default async function PostPage({ params }: { params: { slug: string } }) {
+  const post = await getPost(params.slug);
+  if (!post) notFound();
+  return (
+    <article>
+      <h1>{post.title}</h1>
+      {post.excerpt && <p>{post.excerpt}</p>}
+      {/* Render post.content (TipTap JSON) with your editor/renderer */}
+    </article>
+  );
+}
+```
+
+The CMS API only returns **published** posts; drafts are not included.

package/dist/index.d.mts

@@ -0,0 +1,24 @@
+type Post = {
+    id: string;
+    created_at: string;
+    published_at: string;
+    updated_at: string;
+    site_id: string;
+    title: string;
+    slug: string;
+    content: unknown;
+    excerpt: string | null;
+    featured_image: string | null;
+    published: boolean;
+};
+type DispatchConfig = {
+    siteKey: string;
+};
+declare function initDispatch(options: DispatchConfig): void;
+declare function getConfig(): {
+    siteKey: string;
+};
+declare function getPosts(siteKey?: string): Promise<Post[]>;
+declare function getPost(slug: string, siteKey?: string): Promise<Post | null>;
+
+export { type DispatchConfig, type Post, getConfig, getPost, getPosts, initDispatch };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+type Post = {
+    id: string;
+    created_at: string;
+    published_at: string;
+    updated_at: string;
+    site_id: string;
+    title: string;
+    slug: string;
+    content: unknown;
+    excerpt: string | null;
+    featured_image: string | null;
+    published: boolean;
+};
+type DispatchConfig = {
+    siteKey: string;
+};
+declare function initDispatch(options: DispatchConfig): void;
+declare function getConfig(): {
+    siteKey: string;
+};
+declare function getPosts(siteKey?: string): Promise<Post[]>;
+declare function getPost(slug: string, siteKey?: string): Promise<Post | null>;
+
+export { type DispatchConfig, type Post, getConfig, getPost, getPosts, initDispatch };

package/dist/index.js

@@ -0,0 +1,84 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  getConfig: () => getConfig,
+  getPost: () => getPost,
+  getPosts: () => getPosts,
+  initDispatch: () => initDispatch
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var DISPATCH_API_BASE = "https://dispatch-cms.vercel.app";
+var config = null;
+function initDispatch(options) {
+  config = { siteKey: options.siteKey };
+}
+function getConfig() {
+  const envKey = typeof process !== "undefined" ? process.env?.NEXT_PUBLIC_DISPATCH_SITE_KEY : void 0;
+  const siteKey = config?.siteKey ?? (typeof envKey === "string" ? envKey : void 0);
+  if (!siteKey || typeof siteKey !== "string") {
+    throw new Error("Dispatch site key is required. Call initDispatch({ siteKey }) or set NEXT_PUBLIC_DISPATCH_SITE_KEY.");
+  }
+  return { siteKey };
+}
+async function getPosts(siteKey) {
+  const { siteKey: key } = getConfig();
+  const resolvedKey = siteKey ?? key;
+  const url = `${DISPATCH_API_BASE}/api/posts`;
+  const res = await fetch(url, {
+    headers: { "X-Site-Key": resolvedKey }
+  });
+  if (!res.ok) {
+    if (res.status === 401) {
+      throw new Error("Invalid or missing site key");
+    }
+    throw new Error(`Failed to fetch posts: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+async function getPost(slug, siteKey) {
+  const { siteKey: key } = getConfig();
+  const resolvedKey = siteKey ?? key;
+  const url = `${DISPATCH_API_BASE}/api/posts/${encodeURIComponent(slug)}`;
+  const res = await fetch(url, {
+    headers: { "X-Site-Key": resolvedKey }
+  });
+  if (res.status === 404) {
+    return null;
+  }
+  if (!res.ok) {
+    if (res.status === 401) {
+      throw new Error("Invalid or missing site key");
+    }
+    throw new Error(`Failed to fetch post: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getConfig,
+  getPost,
+  getPosts,
+  initDispatch
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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":[]}

package/dist/index.mjs

@@ -0,0 +1,54 @@
+// src/client.ts
+var DISPATCH_API_BASE = "https://dispatch-cms.vercel.app";
+var config = null;
+function initDispatch(options) {
+  config = { siteKey: options.siteKey };
+}
+function getConfig() {
+  const envKey = typeof process !== "undefined" ? process.env?.NEXT_PUBLIC_DISPATCH_SITE_KEY : void 0;
+  const siteKey = config?.siteKey ?? (typeof envKey === "string" ? envKey : void 0);
+  if (!siteKey || typeof siteKey !== "string") {
+    throw new Error("Dispatch site key is required. Call initDispatch({ siteKey }) or set NEXT_PUBLIC_DISPATCH_SITE_KEY.");
+  }
+  return { siteKey };
+}
+async function getPosts(siteKey) {
+  const { siteKey: key } = getConfig();
+  const resolvedKey = siteKey ?? key;
+  const url = `${DISPATCH_API_BASE}/api/posts`;
+  const res = await fetch(url, {
+    headers: { "X-Site-Key": resolvedKey }
+  });
+  if (!res.ok) {
+    if (res.status === 401) {
+      throw new Error("Invalid or missing site key");
+    }
+    throw new Error(`Failed to fetch posts: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+async function getPost(slug, siteKey) {
+  const { siteKey: key } = getConfig();
+  const resolvedKey = siteKey ?? key;
+  const url = `${DISPATCH_API_BASE}/api/posts/${encodeURIComponent(slug)}`;
+  const res = await fetch(url, {
+    headers: { "X-Site-Key": resolvedKey }
+  });
+  if (res.status === 404) {
+    return null;
+  }
+  if (!res.ok) {
+    if (res.status === 401) {
+      throw new Error("Invalid or missing site key");
+    }
+    throw new Error(`Failed to fetch post: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+export {
+  getConfig,
+  getPost,
+  getPosts,
+  initDispatch
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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":[]}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@dispatchcms/next",
+  "version": "0.0.1",
+  "description": "Fetch published posts from a Dispatch CMS in Next.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "tsx test/getPage.test.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "dispatch",
+    "cms",
+    "nextjs",
+    "content"
+  ],
+  "license": "MIT"
+}

package/src/client.ts

@@ -0,0 +1,69 @@
+export type Post = {
+  id: string;
+  created_at: string;
+  published_at: string;
+  updated_at: string;
+  site_id: string;
+  title: string;
+  slug: string;
+  content: unknown;
+  excerpt: string | null;
+  featured_image: string | null;
+  published: boolean;
+};
+
+const DISPATCH_API_BASE = "https://dispatch-cms.vercel.app";
+
+export type DispatchConfig = {
+  siteKey: string;
+};
+
+let config: DispatchConfig | null = null;
+
+export function initDispatch(options: DispatchConfig): void {
+  config = { siteKey: options.siteKey };
+}
+
+export function getConfig(): { siteKey: string } {
+  const envKey = typeof process !== "undefined" ? process.env?.NEXT_PUBLIC_DISPATCH_SITE_KEY : undefined;
+  const siteKey = config?.siteKey ?? (typeof envKey === "string" ? envKey : undefined);
+  if (!siteKey || typeof siteKey !== "string") {
+    throw new Error("Dispatch site key is required. Call initDispatch({ siteKey }) or set NEXT_PUBLIC_DISPATCH_SITE_KEY.");
+  }
+  return { siteKey };
+}
+
+export async function getPosts(siteKey?: string): Promise<Post[]> {
+  const { siteKey: key } = getConfig();
+  const resolvedKey = siteKey ?? key;
+  const url = `${DISPATCH_API_BASE}/api/posts`;
+  const res = await fetch(url, {
+    headers: { "X-Site-Key": resolvedKey },
+  });
+  if (!res.ok) {
+    if (res.status === 401) {
+      throw new Error("Invalid or missing site key");
+    }
+    throw new Error(`Failed to fetch posts: ${res.status} ${res.statusText}`);
+  }
+  return res.json() as Promise<Post[]>;
+}
+
+export async function getPost(slug: string, siteKey?: string): Promise<Post | null> {
+  const { siteKey: key } = getConfig();
+  const resolvedKey = siteKey ?? key;
+  const url = `${DISPATCH_API_BASE}/api/posts/${encodeURIComponent(slug)}`;
+  const res = await fetch(url, {
+    headers: { "X-Site-Key": resolvedKey },
+  });
+  if (res.status === 404) {
+    return null;
+  }
+  if (!res.ok) {
+    if (res.status === 401) {
+      throw new Error("Invalid or missing site key");
+    }
+    throw new Error(`Failed to fetch post: ${res.status} ${res.statusText}`);
+  }
+  return res.json() as Promise<Post>;
+}

package/src/index.ts

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

package/test/getPage.test.ts

@@ -0,0 +1,14 @@
+import { initDispatch, getPosts } from "../src/index";
+
+async function main() {
+  initDispatch({
+    siteKey: process.env.NEXT_PUBLIC_DISPATCH_SITE_KEY ?? "pk_test",
+  });
+  const result = await getPosts();
+  console.log(result);
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["cjs", "esm"],
+  dts: true,
+  clean: true,
+  sourcemap: true,
+});