@utilsy/cms-nextjs 0.3.0 → 0.5.0

package/README.md

@@ -164,7 +164,68 @@ export function ContactForm() {
 
 Optional honeypot: include `_honeypot` in `data`; submissions with a non-empty value are rejected.
 
-### 6. Client content list (hooks)
+### 6. Newsletter (subscribe, unsubscribe, preferences)
+
+Use your own signup / preference-center UI—no hosted form embed.
+
+```ts
+// app/actions/newsletter.ts
+"use server";
+
+import { cms } from "@/lib/cms";
+
+export async function subscribeNewsletter(email: string) {
+  return cms.newsletter.subscribe({ email, source: "footer" });
+}
+
+export async function unsubscribeNewsletter(email: string) {
+  return cms.newsletter.unsubscribe({ email });
+}
+
+export async function updateNewsletterPrefs(
+  token: string,
+  customFields: Record<string, unknown>,
+) {
+  return cms.newsletter.updatePreferences({ token, customFields });
+}
+```
+
+```tsx
+"use client";
+
+import { CmsProvider, useNewsletterSubscribe } from "@utilsy/cms-nextjs/react";
+import { cms } from "@/lib/cms";
+
+export function NewsletterSignup() {
+  return (
+    <CmsProvider client={cms}>
+      <NewsletterSignupInner />
+    </CmsProvider>
+  );
+}
+
+function NewsletterSignupInner() {
+  const { subscribe, submitting, error } = useNewsletterSubscribe();
+
+  return (
+    <form
+      onSubmit={async (e) => {
+        e.preventDefault();
+        const fd = new FormData(e.currentTarget);
+        await subscribe({ email: String(fd.get("email") ?? "") });
+      }}
+    >
+      <input name="email" type="email" required />
+      <button type="submit" disabled={submitting}>Subscribe</button>
+      {error && <p>{error.message}</p>}
+    </form>
+  );
+}
+```
+
+Confirmation links from email hit `GET /public/newsletter/confirm/:token` (no `siteId` required on the server; the SDK still sends `siteId` when configured).
+
+### 7. Client content list (hooks)
 
 ```tsx
 "use client";
@@ -223,6 +284,41 @@ For local dev or gateway-only deployments, always set `siteId` in the client con
 - `filters` are exact matches on `data.<field>` (JSON query param). Example: `{ category: "news" }`.
 - Use `contentTypeApiId` (kebab-case slug from CMS), not the Mongo content type id.
 
+### COMPONENT and DYNAMIC_ZONE fields
+
+Published entry `data` may include nested structures from the CMS builder:
+
+| Field type | Shape in `entry.data` |
+|------------|------------------------|
+| **COMPONENT** (single) | `{ title: "…", … }` |
+| **COMPONENT** (repeatable) | `[{ … }, { … }]` |
+| **DYNAMIC_ZONE** | `[{ __component: "<apiId>", …fields }, …]` |
+
+Helpers (no extra API calls):
+
+```ts
+import {
+  getComponentItems,
+  getDynamicZoneBlocks,
+  filterDynamicZoneByComponent,
+  parseContentTypeFields,
+} from "@utilsy/cms-nextjs";
+
+const entry = await cms.content.getMappedEntry("landing", "home");
+if (!entry) return;
+
+const slides = getComponentItems(entry, "slides");
+const ctas = filterDynamicZoneByComponent(
+  getDynamicZoneBlocks(entry, "blocks"),
+  "cta",
+);
+
+// Optional: inspect schema from populated contentType on the entry DTO
+const fields = parseContentTypeFields(entry.contentType?.fields);
+```
+
+Types: `FieldType`, `ContentTypeField`, `DynamicZoneBlock`, `ContentTypeCategory`.
+
 ## API reference
 
 ### Client (`createCmsClient`)
@@ -251,10 +347,25 @@ For local dev or gateway-only deployments, always set `siteId` in the client con
 | `content.getEntry(contentTypeApiId, idOrSlug, init?)` | Single raw DTO |
 | `content.listMappedEntries(...)` | List + `mapCmsEntryToContentEntry` |
 | `content.getMappedEntry(...)` | Single mapped `ContentEntry` |
+| `content.getSingleMappedEntry(...)` | First mapped entry for SINGLE types (`limit=1`) |
+
+Query params for `listEntries` / `listMappedEntries`: `page`, `limit`, `search`, `sort`, `order`, `filters` (object). For **SINGLE** content types the public API caps `limit` at 1 and may include `category: "SINGLE"` and `maxEntries: 1` in the list response.
+
+#### Single content types
+
+Use a CMS content type with category **SINGLE** for one document per site (homepage settings, global SEO, etc.). Admin creates the type and edits the auto-created draft on the **Content** tab.
+
+```tsx
+// Prefer for singleton types — no entry id/slug required
+const settings = await client.content.getSingleMappedEntry("site-settings");
 
-Query params for `listEntries` / `listMappedEntries`: `page`, `limit`, `search`, `sort`, `order`, `filters` (object).
+// Or with React
+const { entry, loading } = useSingleContentEntry("site-settings");
+```
+
+`listEntries` / `listMappedEntries` still work; pass `limit: 1` or use `getSingleMappedEntry`.
 
-Helpers: `serializeContentFilters`, `mapCmsEntryToContentEntry`.
+Helpers: `serializeContentFilters`, `mapCmsEntryToContentEntry`, `getComponentItems`, `getDynamicZoneBlocks`, `filterDynamicZoneByComponent`, `parseContentTypeFields`.
 
 #### Leads
 
@@ -266,6 +377,20 @@ Helpers: `serializeContentFilters`, `mapCmsEntryToContentEntry`.
 - Content type must be `LEAD_CAPTURE` and `apiAccess: PUBLIC`
 - Field keys in `data` must match the content type schema; CRM mapping uses `leadCaptureConfig` in admin
 
+#### Newsletter
+
+| Method | Description |
+|--------|-------------|
+| `newsletter.subscribe(input, init?)` | Subscribe by email; may send confirmation email |
+| `newsletter.unsubscribe(input, init?)` | Unsubscribe by `token` (from email) or `email` |
+| `newsletter.confirm(token, init?)` | Confirm subscription from email link |
+| `newsletter.updatePreferences(input, init?)` | Update `customFields`, `tags`, and/or `listId` |
+
+- Base path: `/public/newsletter` (plus optional `pathPrefix`)
+- `subscribe`: `email` required; optional `source`, `listId`, `customFields`
+- `unsubscribe` / `updatePreferences`: provide `token` or `email`
+- `updatePreferences`: at least one of `customFields`, `tags`, or `listId`; optional `tagsAction` (`set` \| `add` \| `remove`)
+
 ### React (`@utilsy/cms-nextjs/react`)
 
 | Export | Description |
@@ -278,7 +403,12 @@ Helpers: `serializeContentFilters`, `mapCmsEntryToContentEntry`.
 | `useBlogComments` | List + submit comments |
 | `useContentEntries` | List mapped entries by content type |
 | `useContentEntry` | Single mapped entry by id or slug |
+| `useSingleContentEntry` | Mapped entry for SINGLE types (no id/slug) |
 | `useSubmitLead` | Submit lead from client (prefer Server Action for forms) |
+| `useNewsletterSubscribe` | Subscribe from client (prefer Server Action) |
+| `useNewsletterUnsubscribe` | Unsubscribe by token or email |
+| `useNewsletterUpdatePreferences` | Update subscriber preferences |
+| `useNewsletterConfirm` | Confirm subscription token (e.g. preference page) |
 
 ## CORS
 
@@ -287,7 +417,7 @@ Public CMS reads from the browser require either:
 - Same-origin proxy (e.g. Next.js Route Handler forwarding to gateway), or
 - Server Components / Route Handlers calling the SDK server-side.
 
-Mutations (comments, likes, lead submit) should run server-side (Server Action / Route Handler) or via a same-origin proxy with CORS configured on the gateway.
+Mutations (comments, likes, lead submit, newsletter subscribe/unsubscribe/preferences) should run server-side (Server Action / Route Handler) or via a same-origin proxy with CORS configured on the gateway.
 
 ## License
 

package/dist/{client-Ba-p3TtH.d.cts → client-awWyf-VL.d.cts}

@@ -181,6 +181,8 @@ type CmsContentTypeDto = {
     id?: string;
     name?: string;
     apiId?: string;
+    /** COLLECTION (many entries), SINGLE (one entry), or COMPONENT (embedded schema only). */
+    category?: string;
     fields?: unknown[];
     status?: string;
 };
@@ -199,11 +201,15 @@ type CmsContentEntriesPage = {
     message?: string;
     docs: CmsContentEntryDto[];
     totalDocs: number;
+    /** Present when the content type category is SINGLE (at most one entry per site). */
+    category?: string;
+    maxEntries?: number;
 };
 type ContentTypeMeta = {
     id: string;
     name: string;
     apiId: string;
+    category?: string;
     fields?: unknown[];
     status?: string;
 };
@@ -219,6 +225,8 @@ type ContentEntry = {
 type MappedContentEntriesPage = {
     entries: ContentEntry[];
     totalDocs: number;
+    category?: string;
+    maxEntries?: number;
 };
 
 type ContentRequestContext = RequestContext & {
@@ -229,6 +237,7 @@ declare function createContentApi(ctx: ContentRequestContext): {
     getEntry(contentTypeApiId: string, idOrSlug: string, init?: FetchRequestInit): Promise<CmsContentEntryDto | null>;
     listMappedEntries(contentTypeApiId: string, query?: ListContentEntriesQuery, init?: FetchRequestInit): Promise<MappedContentEntriesPage | null>;
     getMappedEntry(contentTypeApiId: string, idOrSlug: string, init?: FetchRequestInit): Promise<ContentEntry | null>;
+    getSingleMappedEntry(contentTypeApiId: string, init?: FetchRequestInit): Promise<ContentEntry | null>;
 };
 type ContentApi = ReturnType<typeof createContentApi>;
 
@@ -250,14 +259,65 @@ declare function createLeadsApi(ctx: LeadsRequestContext): {
 };
 type LeadsApi = ReturnType<typeof createLeadsApi>;
 
+type NewsletterSubscriberSummary = {
+    id: string;
+    email?: string;
+    status?: string;
+    tags?: string[];
+    customFields?: Record<string, unknown>;
+};
+type NewsletterActionResult = {
+    ok: boolean;
+    message: string;
+    subscriberId?: string;
+    email?: string;
+    subscriber?: NewsletterSubscriberSummary;
+};
+type SubscribeNewsletterInput = {
+    email: string;
+    source?: string;
+    listId?: string;
+    customFields?: Record<string, unknown>;
+};
+type UnsubscribeNewsletterInput = {
+    /** Token from confirmation or unsubscribe email link */
+    token?: string;
+    email?: string;
+};
+type UpdateNewsletterPreferencesInput = {
+    token?: string;
+    email?: string;
+    /** Merged into existing customFields on the server */
+    customFields?: Record<string, unknown>;
+    tags?: string[];
+    tagsAction?: "set" | "add" | "remove";
+    listId?: string;
+};
+type ConfirmNewsletterResult = {
+    ok: boolean;
+    message: string;
+    email?: string;
+};
+
+type NewsletterRequestContext = RequestContext & {
+    newsletterBasePath: string;
+};
+declare function createNewsletterApi(ctx: NewsletterRequestContext): {
+    subscribe(input: SubscribeNewsletterInput, init?: FetchRequestInit): Promise<NewsletterActionResult>;
+    unsubscribe(input: UnsubscribeNewsletterInput, init?: FetchRequestInit): Promise<NewsletterActionResult>;
+    confirm(token: string, init?: FetchRequestInit): Promise<ConfirmNewsletterResult>;
+    updatePreferences(input: UpdateNewsletterPreferencesInput, init?: FetchRequestInit): Promise<NewsletterActionResult>;
+};
+type NewsletterApi = ReturnType<typeof createNewsletterApi>;
+
 type CmsClientConfig = {
     /** Base URL, e.g. https://cms-gateway.example.com */
     baseUrl: string;
     /** CMS site Mongo id — appended as ?siteId= on every public request */
     siteId?: string;
     /**
-     * Path prefix before /public/blog and /public/api.
-     * Default '' for gateway-cms direct (/public/blog/..., /public/api/...).
+     * Path prefix before /public/blog, /public/api, and /public/newsletter.
+     * Default '' for gateway-cms direct (/public/blog/..., etc.).
      * Use '/api/backend/cms' when routing through the main API gateway.
      */
     pathPrefix?: string;
@@ -268,7 +328,8 @@ type CmsClient = {
     blog: BlogApi;
     content: ContentApi;
     leads: LeadsApi;
+    newsletter: NewsletterApi;
 };
 declare function createCmsClient(config: CmsClientConfig): CmsClient;
 
-export { createCmsClient as A, type BlogApi as B, type CmsApiResponse as C, serializeContentFilters as D, type FetchRequestInit as F, type LeadSubmissionData as L, type MappedContentEntriesPage as M, type SubmitLeadOptions as S, type BlogAuthor as a, type BlogCategory as b, type BlogComment as c, type BlogCommentReply as d, type BlogEngagement as e, type BlogLikeResult as f, type BlogPost as g, type CmsBlogCategoryDto as h, type CmsBlogCommentDto as i, type CmsBlogPostDto as j, type CmsBlogPostsPage as k, type CmsClient as l, type CmsClientConfig as m, type CmsContentEntriesPage as n, type CmsContentEntryDto as o, type CmsContentTypeDto as p, type ContentApi as q, type ContentEntry as r, type ContentFilters as s, type ContentTypeMeta as t, type CreateBlogCommentInput as u, type CreateBlogCommentResult as v, type LeadsApi as w, type ListBlogPostsQuery as x, type ListContentEntriesQuery as y, type SubmitLeadResult as z };
+export { type NewsletterApi as A, type BlogApi as B, type CmsApiResponse as C, type NewsletterSubscriberSummary as D, type SubmitLeadResult as E, type FetchRequestInit as F, type SubscribeNewsletterInput as G, type UpdateNewsletterPreferencesInput as H, createCmsClient as I, serializeContentFilters as J, type LeadSubmissionData as L, type MappedContentEntriesPage as M, type NewsletterActionResult as N, type SubmitLeadOptions as S, type UnsubscribeNewsletterInput as U, type BlogAuthor as a, type BlogCategory as b, type BlogComment as c, type BlogCommentReply as d, type BlogEngagement as e, type BlogLikeResult as f, type BlogPost as g, type CmsBlogCategoryDto as h, type CmsBlogCommentDto as i, type CmsBlogPostDto as j, type CmsBlogPostsPage as k, type CmsClient as l, type CmsClientConfig as m, type CmsContentEntriesPage as n, type CmsContentEntryDto as o, type CmsContentTypeDto as p, type ConfirmNewsletterResult as q, type ContentApi as r, type ContentEntry as s, type ContentFilters as t, type ContentTypeMeta as u, type CreateBlogCommentInput as v, type CreateBlogCommentResult as w, type LeadsApi as x, type ListBlogPostsQuery as y, type ListContentEntriesQuery as z };

package/dist/{client-Ba-p3TtH.d.ts → client-awWyf-VL.d.ts}

@@ -181,6 +181,8 @@ type CmsContentTypeDto = {
     id?: string;
     name?: string;
     apiId?: string;
+    /** COLLECTION (many entries), SINGLE (one entry), or COMPONENT (embedded schema only). */
+    category?: string;
     fields?: unknown[];
     status?: string;
 };
@@ -199,11 +201,15 @@ type CmsContentEntriesPage = {
     message?: string;
     docs: CmsContentEntryDto[];
     totalDocs: number;
+    /** Present when the content type category is SINGLE (at most one entry per site). */
+    category?: string;
+    maxEntries?: number;
 };
 type ContentTypeMeta = {
     id: string;
     name: string;
     apiId: string;
+    category?: string;
     fields?: unknown[];
     status?: string;
 };
@@ -219,6 +225,8 @@ type ContentEntry = {
 type MappedContentEntriesPage = {
     entries: ContentEntry[];
     totalDocs: number;
+    category?: string;
+    maxEntries?: number;
 };
 
 type ContentRequestContext = RequestContext & {
@@ -229,6 +237,7 @@ declare function createContentApi(ctx: ContentRequestContext): {
     getEntry(contentTypeApiId: string, idOrSlug: string, init?: FetchRequestInit): Promise<CmsContentEntryDto | null>;
     listMappedEntries(contentTypeApiId: string, query?: ListContentEntriesQuery, init?: FetchRequestInit): Promise<MappedContentEntriesPage | null>;
     getMappedEntry(contentTypeApiId: string, idOrSlug: string, init?: FetchRequestInit): Promise<ContentEntry | null>;
+    getSingleMappedEntry(contentTypeApiId: string, init?: FetchRequestInit): Promise<ContentEntry | null>;
 };
 type ContentApi = ReturnType<typeof createContentApi>;
 
@@ -250,14 +259,65 @@ declare function createLeadsApi(ctx: LeadsRequestContext): {
 };
 type LeadsApi = ReturnType<typeof createLeadsApi>;
 
+type NewsletterSubscriberSummary = {
+    id: string;
+    email?: string;
+    status?: string;
+    tags?: string[];
+    customFields?: Record<string, unknown>;
+};
+type NewsletterActionResult = {
+    ok: boolean;
+    message: string;
+    subscriberId?: string;
+    email?: string;
+    subscriber?: NewsletterSubscriberSummary;
+};
+type SubscribeNewsletterInput = {
+    email: string;
+    source?: string;
+    listId?: string;
+    customFields?: Record<string, unknown>;
+};
+type UnsubscribeNewsletterInput = {
+    /** Token from confirmation or unsubscribe email link */
+    token?: string;
+    email?: string;
+};
+type UpdateNewsletterPreferencesInput = {
+    token?: string;
+    email?: string;
+    /** Merged into existing customFields on the server */
+    customFields?: Record<string, unknown>;
+    tags?: string[];
+    tagsAction?: "set" | "add" | "remove";
+    listId?: string;
+};
+type ConfirmNewsletterResult = {
+    ok: boolean;
+    message: string;
+    email?: string;
+};
+
+type NewsletterRequestContext = RequestContext & {
+    newsletterBasePath: string;
+};
+declare function createNewsletterApi(ctx: NewsletterRequestContext): {
+    subscribe(input: SubscribeNewsletterInput, init?: FetchRequestInit): Promise<NewsletterActionResult>;
+    unsubscribe(input: UnsubscribeNewsletterInput, init?: FetchRequestInit): Promise<NewsletterActionResult>;
+    confirm(token: string, init?: FetchRequestInit): Promise<ConfirmNewsletterResult>;
+    updatePreferences(input: UpdateNewsletterPreferencesInput, init?: FetchRequestInit): Promise<NewsletterActionResult>;
+};
+type NewsletterApi = ReturnType<typeof createNewsletterApi>;
+
 type CmsClientConfig = {
     /** Base URL, e.g. https://cms-gateway.example.com */
     baseUrl: string;
     /** CMS site Mongo id — appended as ?siteId= on every public request */
     siteId?: string;
     /**
-     * Path prefix before /public/blog and /public/api.
-     * Default '' for gateway-cms direct (/public/blog/..., /public/api/...).
+     * Path prefix before /public/blog, /public/api, and /public/newsletter.
+     * Default '' for gateway-cms direct (/public/blog/..., etc.).
      * Use '/api/backend/cms' when routing through the main API gateway.
      */
     pathPrefix?: string;
@@ -268,7 +328,8 @@ type CmsClient = {
     blog: BlogApi;
     content: ContentApi;
     leads: LeadsApi;
+    newsletter: NewsletterApi;
 };
 declare function createCmsClient(config: CmsClientConfig): CmsClient;
 
-export { createCmsClient as A, type BlogApi as B, type CmsApiResponse as C, serializeContentFilters as D, type FetchRequestInit as F, type LeadSubmissionData as L, type MappedContentEntriesPage as M, type SubmitLeadOptions as S, type BlogAuthor as a, type BlogCategory as b, type BlogComment as c, type BlogCommentReply as d, type BlogEngagement as e, type BlogLikeResult as f, type BlogPost as g, type CmsBlogCategoryDto as h, type CmsBlogCommentDto as i, type CmsBlogPostDto as j, type CmsBlogPostsPage as k, type CmsClient as l, type CmsClientConfig as m, type CmsContentEntriesPage as n, type CmsContentEntryDto as o, type CmsContentTypeDto as p, type ContentApi as q, type ContentEntry as r, type ContentFilters as s, type ContentTypeMeta as t, type CreateBlogCommentInput as u, type CreateBlogCommentResult as v, type LeadsApi as w, type ListBlogPostsQuery as x, type ListContentEntriesQuery as y, type SubmitLeadResult as z };
+export { type NewsletterApi as A, type BlogApi as B, type CmsApiResponse as C, type NewsletterSubscriberSummary as D, type SubmitLeadResult as E, type FetchRequestInit as F, type SubscribeNewsletterInput as G, type UpdateNewsletterPreferencesInput as H, createCmsClient as I, serializeContentFilters as J, type LeadSubmissionData as L, type MappedContentEntriesPage as M, type NewsletterActionResult as N, type SubmitLeadOptions as S, type UnsubscribeNewsletterInput as U, type BlogAuthor as a, type BlogCategory as b, type BlogComment as c, type BlogCommentReply as d, type BlogEngagement as e, type BlogLikeResult as f, type BlogPost as g, type CmsBlogCategoryDto as h, type CmsBlogCommentDto as i, type CmsBlogPostDto as j, type CmsBlogPostsPage as k, type CmsClient as l, type CmsClientConfig as m, type CmsContentEntriesPage as n, type CmsContentEntryDto as o, type CmsContentTypeDto as p, type ConfirmNewsletterResult as q, type ContentApi as r, type ContentEntry as s, type ContentFilters as t, type ContentTypeMeta as u, type CreateBlogCommentInput as v, type CreateBlogCommentResult as w, type LeadsApi as x, type ListBlogPostsQuery as y, type ListContentEntriesQuery as z };

package/dist/index.cjs

@@ -41,6 +41,19 @@ async function publicGetNullable(ctx, path, init) {
     return null;
   }
 }
+async function publicPost(ctx, path, body, init) {
+  const res = await ctx.fetchFn(buildPublicUrl(ctx, path), {
+    ...init,
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      ...ctx.defaultHeaders,
+      ...init?.headers
+    },
+    body: JSON.stringify(body)
+  });
+  return unwrapResponse(res);
+}
 
 // src/blog/mappers.ts
 function mediaUrl(value) {
@@ -226,6 +239,7 @@ function mapContentType(dto) {
     id,
     name: dto.name ?? "",
     apiId: dto.apiId ?? "",
+    category: dto.category,
     fields: dto.fields,
     status: dto.status
   };
@@ -276,13 +290,23 @@ function createContentApi(ctx) {
       if (!page?.docs) return null;
       return {
         entries: page.docs.map(mapCmsEntryToContentEntry),
-        totalDocs: page.totalDocs
+        totalDocs: page.totalDocs,
+        ...page.category ? { category: page.category } : {},
+        ...page.maxEntries != null ? { maxEntries: page.maxEntries } : {}
       };
     },
     async getMappedEntry(contentTypeApiId, idOrSlug, init) {
       const dto = await this.getEntry(contentTypeApiId, idOrSlug, init);
       if (!dto) return null;
       return mapCmsEntryToContentEntry(dto);
+    },
+    async getSingleMappedEntry(contentTypeApiId, init) {
+      const page = await this.listMappedEntries(
+        contentTypeApiId,
+        { limit: 1, page: 1 },
+        init
+      );
+      return page?.entries?.[0] ?? null;
     }
   };
 }
@@ -315,6 +339,29 @@ function createLeadsApi(ctx) {
   };
 }
 
+// src/newsletter/endpoints.ts
+function createNewsletterApi(ctx) {
+  const prefix = ctx.newsletterBasePath;
+  return {
+    subscribe(input, init) {
+      return publicPost(ctx, `${prefix}/subscribe`, input, init);
+    },
+    unsubscribe(input, init) {
+      const body = {};
+      if (input.token) body.token = input.token;
+      if (input.email) body.email = input.email;
+      return publicPost(ctx, `${prefix}/unsubscribe`, body, init);
+    },
+    confirm(token, init) {
+      const path = `${prefix}/confirm/${encodeURIComponent(token)}`;
+      return publicGet(ctx, path, init);
+    },
+    updatePreferences(input, init) {
+      return publicPost(ctx, `${prefix}/preferences`, input, init);
+    }
+  };
+}
+
 // src/client.ts
 function normalizeBaseUrl(url) {
   return url.replace(/\/$/, "");
@@ -329,6 +376,7 @@ function createCmsClient(config) {
   const pathPrefix = normalizePathPrefix(config.pathPrefix ?? "");
   const blogBasePath = `${pathPrefix}/public/blog`.replace(/\/+/g, "/");
   const contentBasePath = `${pathPrefix}/public/api`.replace(/\/+/g, "/");
+  const newsletterBasePath = `${pathPrefix}/public/newsletter`.replace(/\/+/g, "/");
   const ctx = {
     baseUrl,
     siteId: config.siteId,
@@ -338,16 +386,112 @@ function createCmsClient(config) {
   return {
     blog: createBlogApi({ ...ctx, blogBasePath }),
     content: createContentApi({ ...ctx, contentBasePath }),
-    leads: createLeadsApi({ ...ctx, contentBasePath })
+    leads: createLeadsApi({ ...ctx, contentBasePath }),
+    newsletter: createNewsletterApi({ ...ctx, newsletterBasePath })
   };
 }
 
+// src/content/field-types.ts
+var ContentTypeCategory = {
+  COLLECTION: "COLLECTION",
+  SINGLE: "SINGLE",
+  COMPONENT: "COMPONENT"
+};
+var FieldType = {
+  TEXT: "TEXT",
+  TEXTAREA: "TEXTAREA",
+  RICHTEXT: "RICHTEXT",
+  NUMBER: "NUMBER",
+  BOOLEAN: "BOOLEAN",
+  DATE: "DATE",
+  DATETIME: "DATETIME",
+  TIME: "TIME",
+  EMAIL: "EMAIL",
+  URL: "URL",
+  MEDIA: "MEDIA",
+  RELATION: "RELATION",
+  JSON: "JSON",
+  ENUM: "ENUM",
+  PHONE: "PHONE",
+  WEEKDAY: "WEEKDAY",
+  COMPONENT: "COMPONENT",
+  DYNAMIC_ZONE: "DYNAMIC_ZONE",
+  PAGE_EDITOR: "PAGE_EDITOR"
+};
+
+// src/content/structured-data.ts
+function isPlainObject(value) {
+  return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function parseContentTypeFields(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const item of raw) {
+    if (!isPlainObject(item)) continue;
+    const name = item.name;
+    const type = item.type;
+    if (typeof name !== "string" || !name.trim()) continue;
+    if (typeof type !== "string" || !type.trim()) continue;
+    out.push(item);
+  }
+  return out;
+}
+function findContentTypeField(fields, fieldName) {
+  return fields?.find((f) => f.name === fieldName);
+}
+function getEntryFieldValue(entry, fieldName) {
+  return entry.data[fieldName];
+}
+function getComponentItems(entry, fieldName) {
+  const value = entry.data[fieldName];
+  if (value == null) return [];
+  if (Array.isArray(value)) {
+    return value.filter(isPlainObject);
+  }
+  if (isPlainObject(value)) {
+    return [value];
+  }
+  return [];
+}
+function getComponentItem(entry, fieldName) {
+  const items = getComponentItems(entry, fieldName);
+  return items[0];
+}
+function getDynamicZoneBlocks(entry, fieldName) {
+  const value = entry.data[fieldName];
+  if (!Array.isArray(value)) return [];
+  return value.filter(
+    (item) => isPlainObject(item) && typeof item.__component === "string" && item.__component.length > 0
+  );
+}
+function filterDynamicZoneByComponent(blocks, componentApiId) {
+  return blocks.filter((b) => b.__component === componentApiId);
+}
+function isRepeatableComponentField(field) {
+  return field.type === FieldType.COMPONENT && field.component?.repeatable === true;
+}
+function isDynamicZoneField(field) {
+  return field.type === FieldType.DYNAMIC_ZONE;
+}
+
+exports.ContentTypeCategory = ContentTypeCategory;
+exports.FieldType = FieldType;
 exports.createCmsClient = createCmsClient;
+exports.filterDynamicZoneByComponent = filterDynamicZoneByComponent;
+exports.findContentTypeField = findContentTypeField;
+exports.getComponentItem = getComponentItem;
+exports.getComponentItems = getComponentItems;
+exports.getDynamicZoneBlocks = getDynamicZoneBlocks;
+exports.getEntryFieldValue = getEntryFieldValue;
+exports.isDynamicZoneField = isDynamicZoneField;
+exports.isPlainObject = isPlainObject;
+exports.isRepeatableComponentField = isRepeatableComponentField;
 exports.mapCmsCategoryToBlogCategory = mapCmsCategoryToBlogCategory;
 exports.mapCmsCommentToBlogComment = mapCmsCommentToBlogComment;
 exports.mapCmsEntryToContentEntry = mapCmsEntryToContentEntry;
 exports.mapCmsPostToBlogPost = mapCmsPostToBlogPost;
 exports.mediaUrl = mediaUrl;
+exports.parseContentTypeFields = parseContentTypeFields;
 exports.serializeContentFilters = serializeContentFilters;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map