@sprintup-cms/sdk 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to `@sprintup-cms/sdk` will be documented here.
+
+## [1.0.0] — 2026-03-03
+
+### Added
+- `@sprintup-cms/sdk` — zero-dependency typed API client (`cmsClient`, `createCMSClient`)
+  - `getPage`, `getPages`, `getBlogPosts`, `getEvents`, `getAnnouncements`
+  - `getPageType`, `getPageTypes`
+  - `getSiteStructure`
+  - `getPreviewPage`, `getPageWithPreview`
+- `@sprintup-cms/sdk/next` — Next.js 15 App Router helpers
+  - `CMSCatchAllPage` — drop-in catch-all page with draft mode support
+  - `generateMetadata` — SEO metadata from CMS page data
+  - `POST` / `createRevalidateHandler` — on-demand ISR revalidation webhook
+  - `previewExitGET` / `createPreviewExitHandler` — draft mode exit
+- `@sprintup-cms/sdk/react` — React block renderer
+  - `CMSBlocks` — renders all built-in block types + custom overrides
+  - `CMSPreviewBanner` — draft preview banner with exit link
+- Full TypeScript types for all CMS entities

package/README.md

@@ -0,0 +1,169 @@
+# @sprintup-cms/sdk
+
+Official SDK for **SprintUp Forge CMS** — typed API client, Next.js App Router helpers, and a React block renderer.
+
+---
+
+## Install
+
+```bash
+npm install @sprintup-cms/sdk
+```
+
+---
+
+## Quick start
+
+### 1. Environment variables
+
+Add to your school website's `.env.local`:
+
+```env
+NEXT_PUBLIC_CMS_URL=https://your-cms.vercel.app
+CMS_API_KEY=cmsk_xxxxxxxxxxxxxxxxxxxx
+CMS_APP_ID=school-website
+CMS_WEBHOOK_SECRET=your-random-secret
+```
+
+Generate a webhook secret with:
+
+```bash
+openssl rand -hex 32
+```
+
+---
+
+### 2. Catch-all CMS page
+
+Create `app/[...slug]/page.tsx`:
+
+```ts
+export { CMSCatchAllPage as default, generateMetadata } from '@sprintup-cms/sdk/next'
+```
+
+That's it. Every page published in the CMS will be automatically rendered.
+
+---
+
+### 3. On-demand revalidation webhook
+
+Create `app/api/cms-revalidate/route.ts`:
+
+```ts
+export { POST } from '@sprintup-cms/sdk/next'
+```
+
+Then set the webhook URL in your CMS App Settings to:
+
+```
+https://your-school-site.vercel.app/api/cms-revalidate
+```
+
+---
+
+### 4. Preview exit
+
+Create `app/api/cms-preview/exit/route.ts`:
+
+```ts
+export { previewExitGET as GET } from '@sprintup-cms/sdk/next'
+```
+
+---
+
+## Manual usage
+
+### Core client
+
+```ts
+import { cmsClient } from '@sprintup-cms/sdk'
+
+// Get a single page by slug
+const page = await cmsClient.getPage('about')
+
+// Get all blog posts
+const posts = await cmsClient.getBlogPosts()
+
+// Get site structure (nav, footer)
+const structure = await cmsClient.getSiteStructure()
+```
+
+### Custom client instance
+
+```ts
+import { createCMSClient } from '@sprintup-cms/sdk'
+
+const cms = createCMSClient({
+  baseUrl: 'https://your-cms.vercel.app',
+  apiKey:  'cmsk_xxxx',
+  appId:   'school-website',
+})
+```
+
+### React block renderer
+
+```tsx
+import { CMSBlocks, CMSPreviewBanner } from '@sprintup-cms/sdk/react'
+
+export default function Page({ page, pageType, isPreview }) {
+  return (
+    <>
+      <CMSPreviewBanner isPreview={isPreview} status={page.status} slug={page.slug} />
+      <CMSBlocks
+        blocks={page.blocks}
+        pageType={pageType}
+        // Override any block type with your own component:
+        custom={{
+          'my-hero': (block) => <MyHeroComponent {...block.data} />,
+        }}
+      />
+    </>
+  )
+}
+```
+
+---
+
+## Supported block types
+
+| Type | Description |
+|---|---|
+| `heading` | H1–H4 heading |
+| `text` | Plain paragraph |
+| `richtext` | HTML rich text (rendered with `prose`) |
+| `image` | Image with optional caption |
+| `hero` / `hero-section` | Hero with title, subtitle, CTA buttons |
+| `cta` | Call-to-action section |
+| `faq` | Accordion FAQ list |
+| `stats` | Stats grid |
+| `testimonial` | Quote card with author |
+| `quote` | Blockquote |
+| `alert` | Info / success / warning / error banner |
+| `divider` | Horizontal rule |
+| `spacer` | Vertical spacing (sm/md/lg/xl) |
+| `video` | YouTube / Vimeo embed |
+| *(any page type section)* | Rendered as labelled fields from schema |
+
+---
+
+## Entry points
+
+| Import | Contents |
+|---|---|
+| `@sprintup-cms/sdk` | Typed client, all interfaces |
+| `@sprintup-cms/sdk/next` | `CMSCatchAllPage`, `POST` revalidate, `previewExitGET` |
+| `@sprintup-cms/sdk/react` | `CMSBlocks`, `CMSPreviewBanner` |
+
+---
+
+## Requirements
+
+- Node.js 18+
+- Next.js 14+ (for `/next` entry)
+- React 18+ (for `/react` entry)
+
+---
+
+## License
+
+MIT — SprintUp IO

package/dist/client.cjs

@@ -0,0 +1,164 @@
+'use strict';
+
+/* @sprintup-cms/sdk — https://forgecms.io */
+
+// src/client.ts
+function createCMSClient(options) {
+  function cfg() {
+    return {
+      baseUrl: (options?.baseUrl ?? process.env.NEXT_PUBLIC_CMS_URL ?? process.env.CMS_BASE_URL ?? "").replace(/\/$/, ""),
+      apiKey: options?.apiKey ?? process.env.CMS_API_KEY ?? "",
+      appId: options?.appId ?? process.env.CMS_APP_ID ?? ""
+    };
+  }
+  function headers() {
+    return { "X-CMS-API-Key": cfg().apiKey, "Content-Type": "application/json" };
+  }
+  async function getPages(params) {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId) {
+      console.warn("[sprintup-cms] Missing CMS_BASE_URL / CMS_API_KEY / CMS_APP_ID \u2014 returning []");
+      return [];
+    }
+    try {
+      const qs = new URLSearchParams();
+      if (params?.type) qs.set("type", params.type);
+      if (params?.group) qs.set("group", params.group);
+      if (params?.page) qs.set("page", String(params.page));
+      if (params?.perPage) qs.set("perPage", String(params.perPage));
+      const url = `${baseUrl}/api/v1/${appId}/pages${qs.size ? `?${qs}` : ""}`;
+      const res = await fetch(url, {
+        headers: headers(),
+        next: { revalidate: 60, tags: [`cms-pages-${appId}`] }
+      });
+      if (!res.ok) {
+        console.error(`[sprintup-cms] getPages (${res.status})`);
+        return [];
+      }
+      const json = await res.json();
+      return json.data ?? [];
+    } catch (err) {
+      console.error("[sprintup-cms] getPages error:", err);
+      return [];
+    }
+  }
+  async function getPage(slug) {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId) {
+      console.warn("[sprintup-cms] Missing config \u2014 returning null");
+      return null;
+    }
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/pages/${slug}`, {
+        headers: headers(),
+        next: { revalidate: 60, tags: [`cms-page-${slug}`, `cms-pages-${appId}`] }
+      });
+      if (res.status === 404) return null;
+      if (!res.ok) {
+        console.error(`[sprintup-cms] getPage "${slug}" (${res.status})`);
+        return null;
+      }
+      const json = await res.json();
+      return json.data ?? null;
+    } catch (err) {
+      console.error(`[sprintup-cms] getPage "${slug}" error:`, err);
+      return null;
+    }
+  }
+  async function getBlogPosts() {
+    return getPages({ type: "blog-post" });
+  }
+  async function getEvents() {
+    return getPages({ type: "event-page" });
+  }
+  async function getAnnouncements() {
+    return getPages({ type: "announcement-page" });
+  }
+  async function getPreviewPage(token) {
+    const { baseUrl, appId } = cfg();
+    if (!baseUrl || !appId) return null;
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/preview?token=${encodeURIComponent(token)}`, {
+        cache: "no-store"
+      });
+      if (!res.ok) return null;
+      const json = await res.json();
+      return json.data ?? null;
+    } catch {
+      return null;
+    }
+  }
+  async function getPageWithPreview(slug, previewToken) {
+    if (previewToken) {
+      const preview = await getPreviewPage(previewToken);
+      if (preview?.slug === slug) return preview;
+    }
+    return getPage(slug);
+  }
+  async function getPageType(pageTypeId) {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId || !pageTypeId) return null;
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/page-types/${pageTypeId}`, {
+        headers: headers(),
+        next: { revalidate: 3600, tags: [`cms-page-type-${pageTypeId}`] }
+      });
+      if (!res.ok) return null;
+      const json = await res.json();
+      return json.data ?? null;
+    } catch {
+      return null;
+    }
+  }
+  async function getPageTypes() {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId) return [];
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/page-types`, {
+        headers: headers(),
+        next: { revalidate: 3600, tags: [`cms-page-types-${appId}`] }
+      });
+      if (!res.ok) return [];
+      const json = await res.json();
+      return json.data ?? [];
+    } catch {
+      return [];
+    }
+  }
+  async function getSiteStructure() {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId) return null;
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/site-structure`, {
+        headers: headers(),
+        next: {
+          revalidate: 300,
+          tags: [`site-structure-${appId}`]
+        }
+      });
+      if (!res.ok) return null;
+      const json = await res.json();
+      return json.data ?? null;
+    } catch {
+      return null;
+    }
+  }
+  return {
+    getPages,
+    getPage,
+    getBlogPosts,
+    getEvents,
+    getAnnouncements,
+    getPreviewPage,
+    getPageWithPreview,
+    getPageType,
+    getPageTypes,
+    getSiteStructure
+  };
+}
+var cmsClient = createCMSClient();
+
+exports.cmsClient = cmsClient;
+exports.createCMSClient = createCMSClient;
+//# sourceMappingURL=client.cjs.map
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.cjs","sourcesContent":["/**\n * @sprintup-cms/sdk — Core Client\n *\n * Zero-dependency, framework-agnostic typed API client for SprintUp Forge CMS.\n *\n * @example\n * import { cmsClient } from '@sprintup-cms/sdk'\n * const page = await cmsClient.getPage('about')\n *\n * @example Custom instance\n * import { createCMSClient } from '@sprintup-cms/sdk'\n * const cms = createCMSClient({ baseUrl: '...', apiKey: '...', appId: '...' })\n */\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\nexport interface CMSBlock {\n  id: string\n  type: string\n  label?: string\n  locked?: boolean\n  data?: Record<string, any>\n  /** Legacy field — blocks created before v1.1 used `content` instead of `data` */\n  content?: Record<string, any>\n  order?: number\n}\n\nexport interface CMSPage {\n  _id?: string\n  slug: string\n  title: string\n  description?: string\n  pageType?: string\n  pageTypeId?: string\n  variant?: string\n  status: 'draft' | 'published' | 'archived'\n  visibility?: 'public' | 'private' | 'password'\n  blocks: CMSBlock[]\n  publishedAt?: string\n  updatedAt?: string\n  seo?: {\n    title?: string\n    description?: string\n    keywords?: string[]\n    ogImage?: string\n    noIndex?: boolean\n  }\n}\n\nexport interface CMSPageTypeField {\n  id: string\n  name: string\n  label: string\n  fieldType:\n    | 'text' | 'textarea' | 'richtext' | 'image' | 'url'\n    | 'number' | 'boolean' | 'date' | 'select' | 'relation'\n    | 'email' | 'phone' | 'slug' | 'color' | 'embed'\n    | 'multi-select' | 'repeater' | 'file' | 'code'\n  required?: boolean\n  options?: string[]\n  description?: string\n  maxLength?: number\n  multiple?: boolean\n  targetPageTypeKey?: string\n}\n\nexport interface CMSPageTypeSection {\n  id: string\n  name: string\n  label: string\n  order: number\n  locked?: boolean\n  fields: CMSPageTypeField[]\n}\n\nexport interface CMSPageTypeVariant {\n  key: string\n  label: string\n  description?: string\n  visibleSections?: string[]\n}\n\nexport interface CMSPageType {\n  _id: string\n  name: string\n  key: string\n  description?: string\n  icon?: string\n  category: 'singleton' | 'collection' | 'global'\n  contentCategory: 'singleton' | 'collection' | 'global'\n  allowedRoles?: string[]\n  variants: CMSPageTypeVariant[]\n  sections: CMSPageTypeSection[]\n}\n\n// ── Site Structure ─────────────────────────────────────────────────────────────\n\nexport type CMSMenuItemType = 'page' | 'url' | 'dynamic'\n\nexport interface CMSMenuItem {\n  id: string\n  type: CMSMenuItemType\n  label: string\n  contentId?: string\n  url?: string\n  /** Resolved href — ready to pass to <a href> or <Link href>. Never null, falls back to \"#\". */\n  href: string\n  locked: boolean\n  openInNewTab: boolean\n  children: CMSMenuItem[]\n  page?: {\n    title?: string\n    slug?: string\n    seoTitle?: string\n    seoDescription?: string\n  }\n}\n\nexport interface CMSPageTreeNode {\n  id: string\n  contentId: string\n  parentId: string | null\n  order: number\n  locked: boolean\n  visible?: boolean\n  page?: {\n    title?: string\n    slug?: string\n    seoTitle?: string\n    seoDescription?: string\n  }\n}\n\nexport interface CMSFooterGroup {\n  id: string\n  heading: string\n  headingUrl?: string\n  locked: boolean\n  links: CMSMenuItem[]\n}\n\nexport interface CMSSiteStructure {\n  appId: string\n  pageTree: CMSPageTreeNode[]\n  menus: {\n    header: CMSMenuItem[]\n    footer: CMSFooterGroup[]\n    footerBottom: CMSMenuItem[]\n    sidebar: CMSMenuItem[]\n    [slot: string]: CMSMenuItem[] | CMSFooterGroup[]\n  }\n  updatedAt?: string\n}\n\n// ── Pagination & Responses ─────────────────────────────────────────────────────\n\nexport interface CMSListMeta {\n  total: number\n  page: number\n  perPage: number\n  totalPages: number\n}\n\nexport interface CMSListResponse<T = CMSPage> {\n  data: T[]\n  meta: CMSListMeta\n  appId: string\n}\n\nexport interface CMSSingleResponse<T = CMSPage> {\n  data: T\n}\n\n// ── Client Options ─────────────────────────────────────────────────────────────\n\nexport interface CMSClientOptions {\n  /** Base URL of your Forge CMS instance, e.g. https://cms.yourschool.io */\n  baseUrl?: string\n  /** API key generated in CMS Admin → API Keys. Server-side only. */\n  apiKey?: string\n  /** App ID from CMS Admin → Apps, e.g. \"school-website\" */\n  appId?: string\n}\n\nexport interface CMSGetPagesOptions {\n  type?: string\n  group?: string\n  page?: number\n  perPage?: number\n  status?: 'published' | 'draft' | 'archived'\n}\n\n// ── Factory ───────────────────────────────────────────────────────────────────\n\nexport function createCMSClient(options?: CMSClientOptions) {\n  /**\n   * Resolve config lazily at request time — NOT at module/build time.\n   * This prevents static prerendering crashes when env vars are absent during build.\n   */\n  function cfg() {\n    return {\n      baseUrl: (options?.baseUrl ?? process.env.NEXT_PUBLIC_CMS_URL ?? process.env.CMS_BASE_URL ?? '').replace(/\\/$/, ''),\n      apiKey:  options?.apiKey  ?? process.env.CMS_API_KEY  ?? '',\n      appId:   options?.appId   ?? process.env.CMS_APP_ID   ?? '',\n    }\n  }\n\n  function headers() {\n    return { 'X-CMS-API-Key': cfg().apiKey, 'Content-Type': 'application/json' }\n  }\n\n  // ── Pages ──────────────────────────────────────────────────────────────────\n\n  async function getPages(params?: CMSGetPagesOptions): Promise<CMSPage[]> {\n    const { baseUrl, apiKey, appId } = cfg()\n    if (!baseUrl || !apiKey || !appId) {\n      console.warn('[sprintup-cms] Missing CMS_BASE_URL / CMS_API_KEY / CMS_APP_ID — returning []')\n      return []\n    }\n    try {\n      const qs = new URLSearchParams()\n      if (params?.type)    qs.set('type',    params.type)\n      if (params?.group)   qs.set('group',   params.group)\n      if (params?.page)    qs.set('page',    String(params.page))\n      if (params?.perPage) qs.set('perPage', String(params.perPage))\n      const url = `${baseUrl}/api/v1/${appId}/pages${qs.size ? `?${qs}` : ''}`\n      const res = await fetch(url, {\n        headers: headers(),\n        next: { revalidate: 60, tags: [`cms-pages-${appId}`] },\n      } as RequestInit)\n      if (!res.ok) { console.error(`[sprintup-cms] getPages (${res.status})`); return [] }\n      const json: CMSListResponse = await res.json()\n      return json.data ?? []\n    } catch (err) {\n      console.error('[sprintup-cms] getPages error:', err)\n      return []\n    }\n  }\n\n  async function getPage(slug: string): Promise<CMSPage | null> {\n    const { baseUrl, apiKey, appId } = cfg()\n    if (!baseUrl || !apiKey || !appId) {\n      console.warn('[sprintup-cms] Missing config — returning null')\n      return null\n    }\n    try {\n      const res = await fetch(`${baseUrl}/api/v1/${appId}/pages/${slug}`, {\n        headers: headers(),\n        next: { revalidate: 60, tags: [`cms-page-${slug}`, `cms-pages-${appId}`] },\n      } as RequestInit)\n      if (res.status === 404) return null\n      if (!res.ok) { console.error(`[sprintup-cms] getPage \"${slug}\" (${res.status})`); return null }\n      const json: CMSSingleResponse = await res.json()\n      return json.data ?? null\n    } catch (err) {\n      console.error(`[sprintup-cms] getPage \"${slug}\" error:`, err)\n      return null\n    }\n  }\n\n  async function getBlogPosts(): Promise<CMSPage[]> {\n    return getPages({ type: 'blog-post' })\n  }\n\n  async function getEvents(): Promise<CMSPage[]> {\n    return getPages({ type: 'event-page' })\n  }\n\n  async function getAnnouncements(): Promise<CMSPage[]> {\n    return getPages({ type: 'announcement-page' })\n  }\n\n  // ── Preview ────────────────────────────────────────────────────────────────\n\n  async function getPreviewPage(token: string): Promise<CMSPage | null> {\n    const { baseUrl, appId } = cfg()\n    if (!baseUrl || !appId) return null\n    try {\n      const res = await fetch(`${baseUrl}/api/v1/${appId}/preview?token=${encodeURIComponent(token)}`, {\n        cache: 'no-store',\n      })\n      if (!res.ok) return null\n      const json = await res.json()\n      return json.data ?? null\n    } catch {\n      return null\n    }\n  }\n\n  async function getPageWithPreview(slug: string, previewToken?: string | null): Promise<CMSPage | null> {\n    if (previewToken) {\n      const preview = await getPreviewPage(previewToken)\n      if (preview?.slug === slug) return preview\n    }\n    return getPage(slug)\n  }\n\n  // ── Page Types ─────────────────────────────────────────────────────────────\n\n  async function getPageType(pageTypeId: string): Promise<CMSPageType | null> {\n    const { baseUrl, apiKey, appId } = cfg()\n    if (!baseUrl || !apiKey || !appId || !pageTypeId) return null\n    try {\n      const res = await fetch(`${baseUrl}/api/v1/${appId}/page-types/${pageTypeId}`, {\n        headers: headers(),\n        next: { revalidate: 3600, tags: [`cms-page-type-${pageTypeId}`] },\n      } as RequestInit)\n      if (!res.ok) return null\n      const json = await res.json()\n      return json.data ?? null\n    } catch {\n      return null\n    }\n  }\n\n  async function getPageTypes(): Promise<CMSPageType[]> {\n    const { baseUrl, apiKey, appId } = cfg()\n    if (!baseUrl || !apiKey || !appId) return []\n    try {\n      const res = await fetch(`${baseUrl}/api/v1/${appId}/page-types`, {\n        headers: headers(),\n        next: { revalidate: 3600, tags: [`cms-page-types-${appId}`] },\n      } as RequestInit)\n      if (!res.ok) return []\n      const json = await res.json()\n      return json.data ?? []\n    } catch {\n      return []\n    }\n  }\n\n  // ── Site Structure ─────────────────────────────────────────────────────────\n\n  async function getSiteStructure(): Promise<CMSSiteStructure | null> {\n    const { baseUrl, apiKey, appId } = cfg()\n    if (!baseUrl || !apiKey || !appId) return null\n    try {\n      const res = await fetch(`${baseUrl}/api/v1/${appId}/site-structure`, {\n        headers: headers(),\n        next: {\n          revalidate: 300,\n          tags: [`site-structure-${appId}`],\n        },\n      } as RequestInit)\n      if (!res.ok) return null\n      const json = await res.json()\n      return json.data ?? null\n    } catch {\n      return null\n    }\n  }\n\n  return {\n    getPages,\n    getPage,\n    getBlogPosts,\n    getEvents,\n    getAnnouncements,\n    getPreviewPage,\n    getPageWithPreview,\n    getPageType,\n    getPageTypes,\n    getSiteStructure,\n  }\n}\n\n// ── Default singleton ─────────────────────────────────────────────────────────\n\n/** Pre-configured singleton. Reads env vars lazily at request time. */\nexport const cmsClient = createCMSClient()\n"]}

package/dist/client.d.cts

@@ -0,0 +1,190 @@
+/**
+ * @sprintup-cms/sdk — Core Client
+ *
+ * Zero-dependency, framework-agnostic typed API client for SprintUp Forge CMS.
+ *
+ * @example
+ * import { cmsClient } from '@sprintup-cms/sdk'
+ * const page = await cmsClient.getPage('about')
+ *
+ * @example Custom instance
+ * import { createCMSClient } from '@sprintup-cms/sdk'
+ * const cms = createCMSClient({ baseUrl: '...', apiKey: '...', appId: '...' })
+ */
+interface CMSBlock {
+    id: string;
+    type: string;
+    label?: string;
+    locked?: boolean;
+    data?: Record<string, any>;
+    /** Legacy field — blocks created before v1.1 used `content` instead of `data` */
+    content?: Record<string, any>;
+    order?: number;
+}
+interface CMSPage {
+    _id?: string;
+    slug: string;
+    title: string;
+    description?: string;
+    pageType?: string;
+    pageTypeId?: string;
+    variant?: string;
+    status: 'draft' | 'published' | 'archived';
+    visibility?: 'public' | 'private' | 'password';
+    blocks: CMSBlock[];
+    publishedAt?: string;
+    updatedAt?: string;
+    seo?: {
+        title?: string;
+        description?: string;
+        keywords?: string[];
+        ogImage?: string;
+        noIndex?: boolean;
+    };
+}
+interface CMSPageTypeField {
+    id: string;
+    name: string;
+    label: string;
+    fieldType: 'text' | 'textarea' | 'richtext' | 'image' | 'url' | 'number' | 'boolean' | 'date' | 'select' | 'relation' | 'email' | 'phone' | 'slug' | 'color' | 'embed' | 'multi-select' | 'repeater' | 'file' | 'code';
+    required?: boolean;
+    options?: string[];
+    description?: string;
+    maxLength?: number;
+    multiple?: boolean;
+    targetPageTypeKey?: string;
+}
+interface CMSPageTypeSection {
+    id: string;
+    name: string;
+    label: string;
+    order: number;
+    locked?: boolean;
+    fields: CMSPageTypeField[];
+}
+interface CMSPageTypeVariant {
+    key: string;
+    label: string;
+    description?: string;
+    visibleSections?: string[];
+}
+interface CMSPageType {
+    _id: string;
+    name: string;
+    key: string;
+    description?: string;
+    icon?: string;
+    category: 'singleton' | 'collection' | 'global';
+    contentCategory: 'singleton' | 'collection' | 'global';
+    allowedRoles?: string[];
+    variants: CMSPageTypeVariant[];
+    sections: CMSPageTypeSection[];
+}
+type CMSMenuItemType = 'page' | 'url' | 'dynamic';
+interface CMSMenuItem {
+    id: string;
+    type: CMSMenuItemType;
+    label: string;
+    contentId?: string;
+    url?: string;
+    /** Resolved href — ready to pass to <a href> or <Link href>. Never null, falls back to "#". */
+    href: string;
+    locked: boolean;
+    openInNewTab: boolean;
+    children: CMSMenuItem[];
+    page?: {
+        title?: string;
+        slug?: string;
+        seoTitle?: string;
+        seoDescription?: string;
+    };
+}
+interface CMSPageTreeNode {
+    id: string;
+    contentId: string;
+    parentId: string | null;
+    order: number;
+    locked: boolean;
+    visible?: boolean;
+    page?: {
+        title?: string;
+        slug?: string;
+        seoTitle?: string;
+        seoDescription?: string;
+    };
+}
+interface CMSFooterGroup {
+    id: string;
+    heading: string;
+    headingUrl?: string;
+    locked: boolean;
+    links: CMSMenuItem[];
+}
+interface CMSSiteStructure {
+    appId: string;
+    pageTree: CMSPageTreeNode[];
+    menus: {
+        header: CMSMenuItem[];
+        footer: CMSFooterGroup[];
+        footerBottom: CMSMenuItem[];
+        sidebar: CMSMenuItem[];
+        [slot: string]: CMSMenuItem[] | CMSFooterGroup[];
+    };
+    updatedAt?: string;
+}
+interface CMSListMeta {
+    total: number;
+    page: number;
+    perPage: number;
+    totalPages: number;
+}
+interface CMSListResponse<T = CMSPage> {
+    data: T[];
+    meta: CMSListMeta;
+    appId: string;
+}
+interface CMSSingleResponse<T = CMSPage> {
+    data: T;
+}
+interface CMSClientOptions {
+    /** Base URL of your Forge CMS instance, e.g. https://cms.yourschool.io */
+    baseUrl?: string;
+    /** API key generated in CMS Admin → API Keys. Server-side only. */
+    apiKey?: string;
+    /** App ID from CMS Admin → Apps, e.g. "school-website" */
+    appId?: string;
+}
+interface CMSGetPagesOptions {
+    type?: string;
+    group?: string;
+    page?: number;
+    perPage?: number;
+    status?: 'published' | 'draft' | 'archived';
+}
+declare function createCMSClient(options?: CMSClientOptions): {
+    getPages: (params?: CMSGetPagesOptions) => Promise<CMSPage[]>;
+    getPage: (slug: string) => Promise<CMSPage | null>;
+    getBlogPosts: () => Promise<CMSPage[]>;
+    getEvents: () => Promise<CMSPage[]>;
+    getAnnouncements: () => Promise<CMSPage[]>;
+    getPreviewPage: (token: string) => Promise<CMSPage | null>;
+    getPageWithPreview: (slug: string, previewToken?: string | null) => Promise<CMSPage | null>;
+    getPageType: (pageTypeId: string) => Promise<CMSPageType | null>;
+    getPageTypes: () => Promise<CMSPageType[]>;
+    getSiteStructure: () => Promise<CMSSiteStructure | null>;
+};
+/** Pre-configured singleton. Reads env vars lazily at request time. */
+declare const cmsClient: {
+    getPages: (params?: CMSGetPagesOptions) => Promise<CMSPage[]>;
+    getPage: (slug: string) => Promise<CMSPage | null>;
+    getBlogPosts: () => Promise<CMSPage[]>;
+    getEvents: () => Promise<CMSPage[]>;
+    getAnnouncements: () => Promise<CMSPage[]>;
+    getPreviewPage: (token: string) => Promise<CMSPage | null>;
+    getPageWithPreview: (slug: string, previewToken?: string | null) => Promise<CMSPage | null>;
+    getPageType: (pageTypeId: string) => Promise<CMSPageType | null>;
+    getPageTypes: () => Promise<CMSPageType[]>;
+    getSiteStructure: () => Promise<CMSSiteStructure | null>;
+};
+
+export { type CMSBlock, type CMSClientOptions, type CMSFooterGroup, type CMSGetPagesOptions, type CMSListMeta, type CMSListResponse, type CMSMenuItem, type CMSMenuItemType, type CMSPage, type CMSPageTreeNode, type CMSPageType, type CMSPageTypeField, type CMSPageTypeSection, type CMSPageTypeVariant, type CMSSingleResponse, type CMSSiteStructure, cmsClient, createCMSClient };