@sprintup-cms/sdk 1.0.0 → 1.2.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"index.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  /** Used by page-type-renderers to pick a specialised React component */\n  rendererKey?: string\n  /** Active variant key (set per-page) */\n  variant?: string\n  category: 'singleton' | 'collection' | 'global'\n  contentCategory: 'singleton' | 'collection' | 'global'\n  allowedRoles?: string[]\n  variants: CMSPageTypeVariant[]\n  sections: CMSPageTypeSection[]\n}\n\n// ── Sitemap ────────────────────────────────────────────────────────────────────\n\nexport interface CMSSitemapUrl {\n  loc: string\n  lastmod?: string\n  changefreq?: string\n  priority?: number\n  title?: string\n}\n\nexport interface CMSSitemapResponse {\n  enabled: boolean\n  urls: CMSSitemapUrl[]\n  config?: {\n    defaultChangeFreq?: string\n    defaultPriority?: number\n  }\n}\n\n// ── Status ─────────────────────────────────────────────────────────────────────\n\nexport interface CMSStatusResponse {\n  appId: string\n  totalPages: number\n  publishedPages: number\n  connected: boolean\n  pages: Array<{\n    slug: string\n    title: string\n    pageType?: string\n    group?: string\n  }>\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\n// v1 route returns { data, count } — flat, no nested meta object\ninterface CMSListResponse {\n  data: CMSPage[]\n  count: number\n  appId?: string\n}\n\ninterface CMSSingleResponse {\n  data: CMSPage\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  // ── 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  /**\n   * GET /api/v1/{appId}/sitemap\n   * Fetch sitemap data for all published pages (priority, changefreq, lastmod).\n   *\n   * @example app/sitemap.ts\n   *   import type { MetadataRoute } from 'next'\n   *   import { cmsClient } from '@sprintup-cms/sdk'\n   *\n   *   export default async function sitemap(): Promise<MetadataRoute.Sitemap> {\n   *     const data = await cmsClient.getSitemap()\n   *     if (!data?.enabled) return []\n   *     return data.urls.map(url => ({\n   *       url: `${process.env.NEXT_PUBLIC_SITE_URL}${url.loc}`,\n   *       lastModified: url.lastmod,\n   *       changeFrequency: url.changefreq as MetadataRoute.Sitemap[0]['changeFrequency'],\n   *       priority: url.priority,\n   *     }))\n   *   }\n   */\n  async function getSitemap(): Promise<CMSSitemapResponse | 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}/sitemap`, {\n        headers: headers(),\n        next: { revalidate: 3600 },\n      } as RequestInit)\n      if (!res.ok) return null\n      const json = await res.json()\n      return json.data ?? null\n    } catch { return null }\n  }\n\n  /**\n   * GET /api/v1/{appId}/status\n   * Verify connectivity and retrieve page counts. Never cached — always fresh.\n   * Useful for debugging API key setup.\n   */\n  async function getStatus(): Promise<CMSStatusResponse | 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}/status`, {\n        headers: headers(),\n        cache: 'no-store',\n      } as RequestInit)\n      if (!res.ok) return null\n      return await res.json()\n    } catch { return null }\n  }\n\n  return {\n    getPages,\n    getPage,\n    getBlogPosts,\n    getEvents,\n    getAnnouncements,\n    getPreviewPage,\n    getPageWithPreview,\n    getPageType,\n    getSiteStructure,\n    getSitemap,\n    getStatus,\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/index.d.cts

@@ -0,0 +1 @@
+export { CMSBlock, CMSClientOptions, CMSFooterGroup, CMSGetPagesOptions, CMSMenuItem, CMSMenuItemType, CMSPage, CMSPageTreeNode, CMSPageType, CMSPageTypeField, CMSPageTypeSection, CMSPageTypeVariant, CMSSiteStructure, CMSSitemapResponse, CMSSitemapUrl, CMSStatusResponse, cmsClient, createCMSClient } from './client.cjs';

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { CMSBlock, CMSClientOptions, CMSFooterGroup, CMSGetPagesOptions, CMSMenuItem, CMSMenuItemType, CMSPage, CMSPageTreeNode, CMSPageType, CMSPageTypeField, CMSPageTypeSection, CMSPageTypeVariant, CMSSiteStructure, CMSSitemapResponse, CMSSitemapUrl, CMSStatusResponse, cmsClient, createCMSClient } from './client.js';

package/dist/index.js

@@ -0,0 +1,176 @@
+/* @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 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;
+    }
+  }
+  async function getSitemap() {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId) return null;
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/sitemap`, {
+        headers: headers(),
+        next: { revalidate: 3600 }
+      });
+      if (!res.ok) return null;
+      const json = await res.json();
+      return json.data ?? null;
+    } catch {
+      return null;
+    }
+  }
+  async function getStatus() {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId) return null;
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/status`, {
+        headers: headers(),
+        cache: "no-store"
+      });
+      if (!res.ok) return null;
+      return await res.json();
+    } catch {
+      return null;
+    }
+  }
+  return {
+    getPages,
+    getPage,
+    getBlogPosts,
+    getEvents,
+    getAnnouncements,
+    getPreviewPage,
+    getPageWithPreview,
+    getPageType,
+    getSiteStructure,
+    getSitemap,
+    getStatus
+  };
+}
+var cmsClient = createCMSClient();
+
+export { cmsClient, createCMSClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"index.js","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  /** Used by page-type-renderers to pick a specialised React component */\n  rendererKey?: string\n  /** Active variant key (set per-page) */\n  variant?: string\n  category: 'singleton' | 'collection' | 'global'\n  contentCategory: 'singleton' | 'collection' | 'global'\n  allowedRoles?: string[]\n  variants: CMSPageTypeVariant[]\n  sections: CMSPageTypeSection[]\n}\n\n// ── Sitemap ────────────────────────────────────────────────────────────────────\n\nexport interface CMSSitemapUrl {\n  loc: string\n  lastmod?: string\n  changefreq?: string\n  priority?: number\n  title?: string\n}\n\nexport interface CMSSitemapResponse {\n  enabled: boolean\n  urls: CMSSitemapUrl[]\n  config?: {\n    defaultChangeFreq?: string\n    defaultPriority?: number\n  }\n}\n\n// ── Status ─────────────────────────────────────────────────────────────────────\n\nexport interface CMSStatusResponse {\n  appId: string\n  totalPages: number\n  publishedPages: number\n  connected: boolean\n  pages: Array<{\n    slug: string\n    title: string\n    pageType?: string\n    group?: string\n  }>\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\n// v1 route returns { data, count } — flat, no nested meta object\ninterface CMSListResponse {\n  data: CMSPage[]\n  count: number\n  appId?: string\n}\n\ninterface CMSSingleResponse {\n  data: CMSPage\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  // ── 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  /**\n   * GET /api/v1/{appId}/sitemap\n   * Fetch sitemap data for all published pages (priority, changefreq, lastmod).\n   *\n   * @example app/sitemap.ts\n   *   import type { MetadataRoute } from 'next'\n   *   import { cmsClient } from '@sprintup-cms/sdk'\n   *\n   *   export default async function sitemap(): Promise<MetadataRoute.Sitemap> {\n   *     const data = await cmsClient.getSitemap()\n   *     if (!data?.enabled) return []\n   *     return data.urls.map(url => ({\n   *       url: `${process.env.NEXT_PUBLIC_SITE_URL}${url.loc}`,\n   *       lastModified: url.lastmod,\n   *       changeFrequency: url.changefreq as MetadataRoute.Sitemap[0]['changeFrequency'],\n   *       priority: url.priority,\n   *     }))\n   *   }\n   */\n  async function getSitemap(): Promise<CMSSitemapResponse | 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}/sitemap`, {\n        headers: headers(),\n        next: { revalidate: 3600 },\n      } as RequestInit)\n      if (!res.ok) return null\n      const json = await res.json()\n      return json.data ?? null\n    } catch { return null }\n  }\n\n  /**\n   * GET /api/v1/{appId}/status\n   * Verify connectivity and retrieve page counts. Never cached — always fresh.\n   * Useful for debugging API key setup.\n   */\n  async function getStatus(): Promise<CMSStatusResponse | 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}/status`, {\n        headers: headers(),\n        cache: 'no-store',\n      } as RequestInit)\n      if (!res.ok) return null\n      return await res.json()\n    } catch { return null }\n  }\n\n  return {\n    getPages,\n    getPage,\n    getBlogPosts,\n    getEvents,\n    getAnnouncements,\n    getPreviewPage,\n    getPageWithPreview,\n    getPageType,\n    getSiteStructure,\n    getSitemap,\n    getStatus,\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/next/index.cjs

@@ -22,21 +22,29 @@ function createRevalidateHandler(options) {
         return server.NextResponse.json({ error: "Unauthorized" }, { status: 401 });
       }
       const body = await request.json();
-      const { slug, tag } = body;
-      if (!slug) {
-        return server.NextResponse.json({ error: "Missing slug in payload" }, { status: 400 });
+      const { slug, tag, appId, data } = body;
+      if (!tag && !slug) {
+        return server.NextResponse.json({ error: "Missing tag or slug in payload" }, { status: 400 });
+      }
+      if (tag) {
+        cache.revalidateTag(tag);
+      }
+      const resolvedSlug = slug ?? data?.slug ?? tag?.replace(/^content-/, "");
+      if (resolvedSlug) {
+        cache.revalidatePath(`/${resolvedSlug}`);
+        cache.revalidateTag(`cms-page-${resolvedSlug}`);
       }
-      cache.revalidatePath(`/${slug}`);
-      cache.revalidateTag(`cms-page-${slug}`);
       cache.revalidateTag("cms-pages");
-      if (tag) cache.revalidateTag(tag);
-      if (body.event === "published" || body.tag?.startsWith("site-structure")) {
+      const isStructure = tag?.startsWith("site-structure") || body.event === "structure.update";
+      const isPublish = body.event === "published" || body.event === "content.publish";
+      if (isStructure || isPublish) {
         cache.revalidatePath("/", "layout");
       }
       await options?.onRevalidate?.(body);
       return server.NextResponse.json({
         revalidated: true,
-        slug,
+        tag,
+        slug: resolvedSlug,
         event: body.event,
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       });
@@ -169,31 +177,31 @@ function createCMSClient(options) {
       return null;
     }
   }
-  async function getPageTypes() {
+  async function getSiteStructure() {
     const { baseUrl, apiKey, appId } = cfg();
-    if (!baseUrl || !apiKey || !appId) return [];
+    if (!baseUrl || !apiKey || !appId) return null;
     try {
-      const res = await fetch(`${baseUrl}/api/v1/${appId}/page-types`, {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/site-structure`, {
         headers: headers(),
-        next: { revalidate: 3600, tags: [`cms-page-types-${appId}`] }
+        next: {
+          revalidate: 300,
+          tags: [`site-structure-${appId}`]
+        }
       });
-      if (!res.ok) return [];
+      if (!res.ok) return null;
       const json = await res.json();
-      return json.data ?? [];
+      return json.data ?? null;
     } catch {
-      return [];
+      return null;
     }
   }
-  async function getSiteStructure() {
+  async function getSitemap() {
     const { baseUrl, apiKey, appId } = cfg();
     if (!baseUrl || !apiKey || !appId) return null;
     try {
-      const res = await fetch(`${baseUrl}/api/v1/${appId}/site-structure`, {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/sitemap`, {
         headers: headers(),
-        next: {
-          revalidate: 300,
-          tags: [`site-structure-${appId}`]
-        }
+        next: { revalidate: 3600 }
       });
       if (!res.ok) return null;
       const json = await res.json();
@@ -202,6 +210,20 @@ function createCMSClient(options) {
       return null;
     }
   }
+  async function getStatus() {
+    const { baseUrl, apiKey, appId } = cfg();
+    if (!baseUrl || !apiKey || !appId) return null;
+    try {
+      const res = await fetch(`${baseUrl}/api/v1/${appId}/status`, {
+        headers: headers(),
+        cache: "no-store"
+      });
+      if (!res.ok) return null;
+      return await res.json();
+    } catch {
+      return null;
+    }
+  }
   return {
     getPages,
     getPage,
@@ -211,8 +233,9 @@ function createCMSClient(options) {
     getPreviewPage,
     getPageWithPreview,
     getPageType,
-    getPageTypes,
-    getSiteStructure
+    getSiteStructure,
+    getSitemap,
+    getStatus
   };
 }
 function getData(block) {