@sprintup-cms/sdk 1.0.0

package/dist/client.d.ts

@@ -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 };

package/dist/client.js

@@ -0,0 +1,161 @@
+/* @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();
+
+export { cmsClient, createCMSClient };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"client.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  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"]}