@bettercms-ai/sdk 1.32.0 → 1.34.0

package/dist/seo.cjs

@@ -0,0 +1,153 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/seo.ts
+var seo_exports = {};
+__export(seo_exports, {
+  entrySeoInput: () => entrySeoInput,
+  resolveSeo: () => resolveSeo
+});
+module.exports = __toCommonJS(seo_exports);
+function derivedCanonical({ siteUrl, path }) {
+  if (!siteUrl || !path) return "";
+  try {
+    return new URL(path, siteUrl.endsWith("/") ? siteUrl : `${siteUrl}/`).toString();
+  } catch {
+    return "";
+  }
+}
+function jsonLdNodes(schema) {
+  if (!schema) return [];
+  const arr = Array.isArray(schema) ? schema : [schema];
+  const out = [];
+  for (const node of arr) {
+    if (!node || Object.keys(node).length === 0) continue;
+    const graph = node["@graph"];
+    if (Array.isArray(graph)) {
+      for (const child of graph) {
+        if (child && typeof child === "object" && !Array.isArray(child) && Object.keys(child).length > 0) {
+          out.push(child);
+        }
+      }
+      continue;
+    }
+    out.push(node);
+  }
+  return out;
+}
+var SCHEMA_TYPE_CHOICES = [
+  "WebPage",
+  "AboutPage",
+  "ContactPage",
+  "CollectionPage",
+  "Blog",
+  "BlogPosting",
+  "Article",
+  "Product",
+  "FAQPage",
+  "Event",
+  "Organization",
+  "LocalBusiness"
+];
+function compact(node) {
+  return Object.fromEntries(Object.entries(node).filter(([, value]) => value != null && value !== ""));
+}
+function schemaNode(type, { name, description, image, url }) {
+  switch (type) {
+    case "BlogPosting":
+    case "Article":
+      return compact({ "@type": type, headline: name, description, image, url, mainEntityOfPage: url });
+    case "Product":
+    case "Event":
+      return compact({ "@type": type, name, description, image, url });
+    case "FAQPage":
+    case "WebSite":
+      return compact({ "@type": type, name, description, url });
+    case "Organization":
+      return compact({ "@type": type, name, description, url, logo: image });
+    default:
+      return compact({ "@type": type, name, description, url, image });
+  }
+}
+function pageJsonLd(page, meta, canonical, siteSchema) {
+  const custom = jsonLdNodes(meta.schema);
+  if (custom.length > 0) return custom;
+  const props = {
+    name: (page.metaTitle || page.title || "").trim(),
+    description: (page.metaDescription || "").trim(),
+    image: (meta.og?.image || "").trim(),
+    url: canonical.trim()
+  };
+  const schemaType = meta.schemaType;
+  if (typeof schemaType === "string" && SCHEMA_TYPE_CHOICES.includes(schemaType)) {
+    return [schemaNode(schemaType, props)];
+  }
+  if (page.slug === "home") {
+    return jsonLdNodes(siteSchema).length > 0 ? [] : [schemaNode("WebSite", props)];
+  }
+  return [schemaNode("WebPage", props)];
+}
+function entrySeoInput(entry) {
+  const { metaTitle, metaDescription, noindex, ...metaJson } = entry.seo ?? {};
+  return {
+    title: metaTitle || entry.slug,
+    metaTitle: metaTitle ?? null,
+    metaDescription: metaDescription ?? null,
+    metaJson,
+    noindex: noindex === true
+  };
+}
+function resolveSeo(page, defaults = {}, location = {}) {
+  const meta = page.metaJson ?? {};
+  const title = page.metaTitle || page.title || "";
+  const description = page.metaDescription || defaults.metaDescription || "";
+  const ogImage = meta.og?.image || defaults.og?.image || defaults.ogImage || "";
+  const ogTitle = meta.og?.title || title;
+  const ogDescription = meta.og?.description || description;
+  const twImage = meta.twitter?.image || ogImage;
+  const canonical = meta.canonical || derivedCanonical(location);
+  return {
+    title,
+    description,
+    canonical,
+    og: {
+      title: ogTitle,
+      description: ogDescription,
+      type: meta.og?.type || defaults.og?.type || "website",
+      image: ogImage,
+      url: canonical
+    },
+    twitter: {
+      card: meta.twitter?.card || defaults.twitter?.card || (twImage ? "summary_large_image" : "summary"),
+      title: meta.twitter?.title || ogTitle,
+      description: meta.twitter?.description || ogDescription,
+      image: twImage,
+      site: defaults.twitterHandle || ""
+    },
+    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...pageJsonLd(page, meta, canonical, defaults.siteSchema)],
+    noindex: page.noindex === true,
+    robots: { index: page.noindex !== true, follow: true }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  entrySeoInput,
+  resolveSeo
+});
+//# sourceMappingURL=seo.cjs.map

package/dist/seo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/seo.ts"],"sourcesContent":["/**\n * resolveSeo — framework-agnostic page-over-site SEO merge for headless consumers.\n *\n * The single source of truth for \"per-page meta layered over project defaults\",\n * mirroring the server renderer's `mergeSeoMeta` so `*.bettercms.site` and headless\n * sites (@bettercms-ai/next, @bettercms-ai/astro) emit identical <head> SEO. Pure: empty\n * inputs collapse to empty strings (\"omit the tag\"), never fabricated values.\n *\n *   const seo = resolveSeo(page, siteDefaults);\n *   // → { title, description, canonical, og, twitter, jsonLd }\n *\n * Next consumers map this to a `Metadata` via `buildMetadata` (@bettercms-ai/next);\n * Astro consumers read the fields straight into `<head>`.\n */\nimport type { DeliveryEntrySeo, PageMetaJson, SiteSeoDefaults } from \"@bettercms-ai/types\";\n\n/** Minimal page shape `resolveSeo` reads — a `DeliveryPage`/`BetterCMSPage` satisfies it. */\nexport interface SeoInput {\n  title: string;\n  metaTitle?: string | null;\n  metaDescription?: string | null;\n  metaJson?: PageMetaJson | null;\n  /** `\"home\"` makes the Automatic JSON-LD a WebSite, as the hosted renderer does. */\n  slug?: string | null;\n  /** Exclude from search engines. Surfaces as `ResolvedSeo.noindex` / `robots`. */\n  noindex?: boolean | null;\n}\n\n/** Fully-resolved SEO values, page-over-site. Empty string ⇒ omit that tag. */\nexport interface ResolvedSeo {\n  title: string;\n  description: string;\n  /**\n   * Canonical URL — the page's own `canonical`, else `siteUrl` + `path` when both are given,\n   * else \"\". Empty means the consumer must omit the tag: a RELATIVE canonical is worse than\n   * none at all.\n   */\n  canonical: string;\n  og: {\n    title: string;\n    description: string;\n    type: string;\n    image: string;\n    url: string;\n  };\n  twitter: {\n    card: string;\n    title: string;\n    description: string;\n    image: string;\n    site: string;\n  };\n  /**\n   * JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. The page's\n   * part follows the renderer's precedence: Custom (`metaJson.schema`) > `metaJson.schemaType` >\n   * Automatic (WebPage; WebSite on the home page).\n   */\n  jsonLd: Array<Record<string, unknown>>;\n  /** True when the page is excluded from search engines (the renderer's `<meta name=\"robots\" content=\"noindex\">`). */\n  noindex: boolean;\n  /** `noindex` in the `{ index, follow }` shape Next's `Metadata.robots` takes. */\n  robots: { index: boolean; follow: boolean };\n}\n\n/**\n * `siteUrl` + `path` → an absolute canonical, or \"\" when either is missing or unparseable.\n * Never returns a relative URL: a relative canonical is worse than no canonical.\n */\nfunction derivedCanonical({ siteUrl, path }: SeoLocation): string {\n  if (!siteUrl || !path) return \"\";\n  try {\n    return new URL(path, siteUrl.endsWith(\"/\") ? siteUrl : `${siteUrl}/`).toString();\n  } catch {\n    return \"\";\n  }\n}\n\n/** Flatten one-or-many JSON-LD into a node array, dropping empty objects. */\nfunction jsonLdNodes(\n  schema: Record<string, unknown> | Array<Record<string, unknown>> | undefined,\n): Array<Record<string, unknown>> {\n  if (!schema) return [];\n  const arr = Array.isArray(schema) ? schema : [schema];\n  const out: Array<Record<string, unknown>> = [];\n  for (const node of arr) {\n    if (!node || Object.keys(node).length === 0) continue;\n    const graph = node[\"@graph\"];\n    if (Array.isArray(graph)) {\n      for (const child of graph) {\n        if (child && typeof child === \"object\" && !Array.isArray(child) && Object.keys(child).length > 0) {\n          out.push(child as Record<string, unknown>);\n        }\n      }\n      continue;\n    }\n    out.push(node);\n  }\n  return out;\n}\n\n/*\n * Structured data for a page whose `metaJson.schema` is empty. A port of the page path of\n * `resolveStructuredData` in the backend (src/lib/seo/structured-data.ts, called from\n * `pageStructuredData` in src/lib/sites/render-page.ts), with `site.include: false` as the\n * Delivery API calls it: the site-wide schema is emitted separately, from `siteSchema`.\n * A page has no field data, so only the properties the page's own meta supplies are filled.\n * Keep in step with that file; the parity test imports it.\n */\nconst SCHEMA_TYPE_CHOICES = [\n  \"WebPage\",\n  \"AboutPage\",\n  \"ContactPage\",\n  \"CollectionPage\",\n  \"Blog\",\n  \"BlogPosting\",\n  \"Article\",\n  \"Product\",\n  \"FAQPage\",\n  \"Event\",\n  \"Organization\",\n  \"LocalBusiness\",\n] as const;\n\ntype PageProps = { name: string; description: string; image: string; url: string };\n\n/** Drop \"\", null and undefined so a node never carries a blank. */\nfunction compact(node: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(node).filter(([, value]) => value != null && value !== \"\"));\n}\n\nfunction schemaNode(type: string, { name, description, image, url }: PageProps): Record<string, unknown> {\n  switch (type) {\n    case \"BlogPosting\":\n    case \"Article\":\n      return compact({ \"@type\": type, headline: name, description, image, url, mainEntityOfPage: url });\n    case \"Product\":\n    case \"Event\":\n      return compact({ \"@type\": type, name, description, image, url });\n    case \"FAQPage\":\n    case \"WebSite\":\n      return compact({ \"@type\": type, name, description, url });\n    case \"Organization\":\n      return compact({ \"@type\": type, name, description, url, logo: image });\n    default:\n      // WebPage, AboutPage, ContactPage, CollectionPage, Blog, LocalBusiness\n      return compact({ \"@type\": type, name, description, url, image });\n  }\n}\n\n/** The page's own JSON-LD nodes: Custom > explicit `schemaType` > Automatic. */\nfunction pageJsonLd(\n  page: SeoInput,\n  meta: PageMetaJson,\n  canonical: string,\n  siteSchema: SiteSeoDefaults[\"siteSchema\"],\n): Array<Record<string, unknown>> {\n  const custom = jsonLdNodes(meta.schema);\n  if (custom.length > 0) return custom;\n  const props: PageProps = {\n    name: (page.metaTitle || page.title || \"\").trim(),\n    description: (page.metaDescription || \"\").trim(),\n    image: (meta.og?.image || \"\").trim(),\n    url: canonical.trim(),\n  };\n  const schemaType = (meta as { schemaType?: unknown }).schemaType;\n  if (typeof schemaType === \"string\" && (SCHEMA_TYPE_CHOICES as readonly string[]).includes(schemaType)) {\n    return [schemaNode(schemaType, props)];\n  }\n  if (page.slug === \"home\") {\n    // The home page IS the WebSite, unless the site-wide schema already describes it.\n    return jsonLdNodes(siteSchema).length > 0 ? [] : [schemaNode(\"WebSite\", props)];\n  }\n  return [schemaNode(\"WebPage\", props)];\n}\n\n/**\n * A Delivery API entry as a `resolveSeo` input. The server already resolved the collection\n * template's `{{field}}` tokens for this entry and merged the entry's own SEO over it, so this is\n * a reshape, not a resolver:\n *\n *   const entry = await bcms.getEntry(\"astro\");\n *   const seo = resolveSeo(entrySeoInput(entry), siteDefaults, { siteUrl, path: `/tags/${entry.slug}` });\n *   // seo.jsonLd holds the template's schema, resolved for this entry\n */\nexport function entrySeoInput(entry: { slug: string; seo?: DeliveryEntrySeo | null }): SeoInput {\n  const { metaTitle, metaDescription, noindex, ...metaJson } = entry.seo ?? {};\n  return {\n    title: metaTitle || entry.slug,\n    metaTitle: metaTitle ?? null,\n    metaDescription: metaDescription ?? null,\n    metaJson,\n    noindex: noindex === true,\n  };\n}\n\n/** Where this page lives, so a canonical can be derived when the page sets none. */\nexport interface SeoLocation {\n  /** Absolute site origin, e.g. `https://acme.com`. Trailing slash optional. */\n  siteUrl?: string;\n  /** This page's path, e.g. `/about` or `/`. */\n  path?: string;\n}\n\n/**\n * Merge a page's own SEO over the site defaults: page meta wins, then site defaults, then\n * sensible fallbacks.\n *\n * The CANONICAL is the one field that cannot be resolved from content alone, and getting this\n * wrong is silent. The hosted renderer (`mergeSeoMeta` in the backend) falls back to a canonical\n * it derives from the request's own origin and path — headless consumers have no request, so\n * they must pass `location`. Without it this returns \"\" and the caller ships no\n * `<link rel=\"canonical\">` and no `og:url`, exactly as it did before `location` existed.\n */\nexport function resolveSeo(\n  page: SeoInput,\n  defaults: SiteSeoDefaults = {},\n  location: SeoLocation = {},\n): ResolvedSeo {\n  const meta = page.metaJson ?? {};\n  const title = page.metaTitle || page.title || \"\";\n  const description = page.metaDescription || defaults.metaDescription || \"\";\n  const ogImage = meta.og?.image || defaults.og?.image || defaults.ogImage || \"\";\n  const ogTitle = meta.og?.title || title;\n  const ogDescription = meta.og?.description || description;\n  const twImage = meta.twitter?.image || ogImage;\n  const canonical = meta.canonical || derivedCanonical(location);\n  return {\n    title,\n    description,\n    canonical,\n    og: {\n      title: ogTitle,\n      description: ogDescription,\n      type: meta.og?.type || defaults.og?.type || \"website\",\n      image: ogImage,\n      url: canonical,\n    },\n    twitter: {\n      card: meta.twitter?.card || defaults.twitter?.card || (twImage ? \"summary_large_image\" : \"summary\"),\n      title: meta.twitter?.title || ogTitle,\n      description: meta.twitter?.description || ogDescription,\n      image: twImage,\n      site: defaults.twitterHandle || \"\",\n    },\n    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...pageJsonLd(page, meta, canonical, defaults.siteSchema)],\n    noindex: page.noindex === true,\n    robots: { index: page.noindex !== true, follow: true },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/seo.d.cts

@@ -0,0 +1,99 @@
+import { PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults } from '@bettercms-ai/types';
+
+/**
+ * resolveSeo — framework-agnostic page-over-site SEO merge for headless consumers.
+ *
+ * The single source of truth for "per-page meta layered over project defaults",
+ * mirroring the server renderer's `mergeSeoMeta` so `*.bettercms.site` and headless
+ * sites (@bettercms-ai/next, @bettercms-ai/astro) emit identical <head> SEO. Pure: empty
+ * inputs collapse to empty strings ("omit the tag"), never fabricated values.
+ *
+ *   const seo = resolveSeo(page, siteDefaults);
+ *   // → { title, description, canonical, og, twitter, jsonLd }
+ *
+ * Next consumers map this to a `Metadata` via `buildMetadata` (@bettercms-ai/next);
+ * Astro consumers read the fields straight into `<head>`.
+ */
+
+/** Minimal page shape `resolveSeo` reads — a `DeliveryPage`/`BetterCMSPage` satisfies it. */
+interface SeoInput {
+    title: string;
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+    metaJson?: PageMetaJson | null;
+    /** `"home"` makes the Automatic JSON-LD a WebSite, as the hosted renderer does. */
+    slug?: string | null;
+    /** Exclude from search engines. Surfaces as `ResolvedSeo.noindex` / `robots`. */
+    noindex?: boolean | null;
+}
+/** Fully-resolved SEO values, page-over-site. Empty string ⇒ omit that tag. */
+interface ResolvedSeo {
+    title: string;
+    description: string;
+    /**
+     * Canonical URL — the page's own `canonical`, else `siteUrl` + `path` when both are given,
+     * else "". Empty means the consumer must omit the tag: a RELATIVE canonical is worse than
+     * none at all.
+     */
+    canonical: string;
+    og: {
+        title: string;
+        description: string;
+        type: string;
+        image: string;
+        url: string;
+    };
+    twitter: {
+        card: string;
+        title: string;
+        description: string;
+        image: string;
+        site: string;
+    };
+    /**
+     * JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. The page's
+     * part follows the renderer's precedence: Custom (`metaJson.schema`) > `metaJson.schemaType` >
+     * Automatic (WebPage; WebSite on the home page).
+     */
+    jsonLd: Array<Record<string, unknown>>;
+    /** True when the page is excluded from search engines (the renderer's `<meta name="robots" content="noindex">`). */
+    noindex: boolean;
+    /** `noindex` in the `{ index, follow }` shape Next's `Metadata.robots` takes. */
+    robots: {
+        index: boolean;
+        follow: boolean;
+    };
+}
+/**
+ * A Delivery API entry as a `resolveSeo` input. The server already resolved the collection
+ * template's `{{field}}` tokens for this entry and merged the entry's own SEO over it, so this is
+ * a reshape, not a resolver:
+ *
+ *   const entry = await bcms.getEntry("astro");
+ *   const seo = resolveSeo(entrySeoInput(entry), siteDefaults, { siteUrl, path: `/tags/${entry.slug}` });
+ *   // seo.jsonLd holds the template's schema, resolved for this entry
+ */
+declare function entrySeoInput(entry: {
+    slug: string;
+    seo?: DeliveryEntrySeo | null;
+}): SeoInput;
+/** Where this page lives, so a canonical can be derived when the page sets none. */
+interface SeoLocation {
+    /** Absolute site origin, e.g. `https://acme.com`. Trailing slash optional. */
+    siteUrl?: string;
+    /** This page's path, e.g. `/about` or `/`. */
+    path?: string;
+}
+/**
+ * Merge a page's own SEO over the site defaults: page meta wins, then site defaults, then
+ * sensible fallbacks.
+ *
+ * The CANONICAL is the one field that cannot be resolved from content alone, and getting this
+ * wrong is silent. The hosted renderer (`mergeSeoMeta` in the backend) falls back to a canonical
+ * it derives from the request's own origin and path — headless consumers have no request, so
+ * they must pass `location`. Without it this returns "" and the caller ships no
+ * `<link rel="canonical">` and no `og:url`, exactly as it did before `location` existed.
+ */
+declare function resolveSeo(page: SeoInput, defaults?: SiteSeoDefaults, location?: SeoLocation): ResolvedSeo;
+
+export { type ResolvedSeo, type SeoInput, type SeoLocation, entrySeoInput, resolveSeo };

package/dist/seo.d.ts

@@ -0,0 +1,99 @@
+import { PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults } from '@bettercms-ai/types';
+
+/**
+ * resolveSeo — framework-agnostic page-over-site SEO merge for headless consumers.
+ *
+ * The single source of truth for "per-page meta layered over project defaults",
+ * mirroring the server renderer's `mergeSeoMeta` so `*.bettercms.site` and headless
+ * sites (@bettercms-ai/next, @bettercms-ai/astro) emit identical <head> SEO. Pure: empty
+ * inputs collapse to empty strings ("omit the tag"), never fabricated values.
+ *
+ *   const seo = resolveSeo(page, siteDefaults);
+ *   // → { title, description, canonical, og, twitter, jsonLd }
+ *
+ * Next consumers map this to a `Metadata` via `buildMetadata` (@bettercms-ai/next);
+ * Astro consumers read the fields straight into `<head>`.
+ */
+
+/** Minimal page shape `resolveSeo` reads — a `DeliveryPage`/`BetterCMSPage` satisfies it. */
+interface SeoInput {
+    title: string;
+    metaTitle?: string | null;
+    metaDescription?: string | null;
+    metaJson?: PageMetaJson | null;
+    /** `"home"` makes the Automatic JSON-LD a WebSite, as the hosted renderer does. */
+    slug?: string | null;
+    /** Exclude from search engines. Surfaces as `ResolvedSeo.noindex` / `robots`. */
+    noindex?: boolean | null;
+}
+/** Fully-resolved SEO values, page-over-site. Empty string ⇒ omit that tag. */
+interface ResolvedSeo {
+    title: string;
+    description: string;
+    /**
+     * Canonical URL — the page's own `canonical`, else `siteUrl` + `path` when both are given,
+     * else "". Empty means the consumer must omit the tag: a RELATIVE canonical is worse than
+     * none at all.
+     */
+    canonical: string;
+    og: {
+        title: string;
+        description: string;
+        type: string;
+        image: string;
+        url: string;
+    };
+    twitter: {
+        card: string;
+        title: string;
+        description: string;
+        image: string;
+        site: string;
+    };
+    /**
+     * JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. The page's
+     * part follows the renderer's precedence: Custom (`metaJson.schema`) > `metaJson.schemaType` >
+     * Automatic (WebPage; WebSite on the home page).
+     */
+    jsonLd: Array<Record<string, unknown>>;
+    /** True when the page is excluded from search engines (the renderer's `<meta name="robots" content="noindex">`). */
+    noindex: boolean;
+    /** `noindex` in the `{ index, follow }` shape Next's `Metadata.robots` takes. */
+    robots: {
+        index: boolean;
+        follow: boolean;
+    };
+}
+/**
+ * A Delivery API entry as a `resolveSeo` input. The server already resolved the collection
+ * template's `{{field}}` tokens for this entry and merged the entry's own SEO over it, so this is
+ * a reshape, not a resolver:
+ *
+ *   const entry = await bcms.getEntry("astro");
+ *   const seo = resolveSeo(entrySeoInput(entry), siteDefaults, { siteUrl, path: `/tags/${entry.slug}` });
+ *   // seo.jsonLd holds the template's schema, resolved for this entry
+ */
+declare function entrySeoInput(entry: {
+    slug: string;
+    seo?: DeliveryEntrySeo | null;
+}): SeoInput;
+/** Where this page lives, so a canonical can be derived when the page sets none. */
+interface SeoLocation {
+    /** Absolute site origin, e.g. `https://acme.com`. Trailing slash optional. */
+    siteUrl?: string;
+    /** This page's path, e.g. `/about` or `/`. */
+    path?: string;
+}
+/**
+ * Merge a page's own SEO over the site defaults: page meta wins, then site defaults, then
+ * sensible fallbacks.
+ *
+ * The CANONICAL is the one field that cannot be resolved from content alone, and getting this
+ * wrong is silent. The hosted renderer (`mergeSeoMeta` in the backend) falls back to a canonical
+ * it derives from the request's own origin and path — headless consumers have no request, so
+ * they must pass `location`. Without it this returns "" and the caller ships no
+ * `<link rel="canonical">` and no `og:url`, exactly as it did before `location` existed.
+ */
+declare function resolveSeo(page: SeoInput, defaults?: SiteSeoDefaults, location?: SeoLocation): ResolvedSeo;
+
+export { type ResolvedSeo, type SeoInput, type SeoLocation, entrySeoInput, resolveSeo };

package/dist/seo.js

@@ -0,0 +1,127 @@
+// src/seo.ts
+function derivedCanonical({ siteUrl, path }) {
+  if (!siteUrl || !path) return "";
+  try {
+    return new URL(path, siteUrl.endsWith("/") ? siteUrl : `${siteUrl}/`).toString();
+  } catch {
+    return "";
+  }
+}
+function jsonLdNodes(schema) {
+  if (!schema) return [];
+  const arr = Array.isArray(schema) ? schema : [schema];
+  const out = [];
+  for (const node of arr) {
+    if (!node || Object.keys(node).length === 0) continue;
+    const graph = node["@graph"];
+    if (Array.isArray(graph)) {
+      for (const child of graph) {
+        if (child && typeof child === "object" && !Array.isArray(child) && Object.keys(child).length > 0) {
+          out.push(child);
+        }
+      }
+      continue;
+    }
+    out.push(node);
+  }
+  return out;
+}
+var SCHEMA_TYPE_CHOICES = [
+  "WebPage",
+  "AboutPage",
+  "ContactPage",
+  "CollectionPage",
+  "Blog",
+  "BlogPosting",
+  "Article",
+  "Product",
+  "FAQPage",
+  "Event",
+  "Organization",
+  "LocalBusiness"
+];
+function compact(node) {
+  return Object.fromEntries(Object.entries(node).filter(([, value]) => value != null && value !== ""));
+}
+function schemaNode(type, { name, description, image, url }) {
+  switch (type) {
+    case "BlogPosting":
+    case "Article":
+      return compact({ "@type": type, headline: name, description, image, url, mainEntityOfPage: url });
+    case "Product":
+    case "Event":
+      return compact({ "@type": type, name, description, image, url });
+    case "FAQPage":
+    case "WebSite":
+      return compact({ "@type": type, name, description, url });
+    case "Organization":
+      return compact({ "@type": type, name, description, url, logo: image });
+    default:
+      return compact({ "@type": type, name, description, url, image });
+  }
+}
+function pageJsonLd(page, meta, canonical, siteSchema) {
+  const custom = jsonLdNodes(meta.schema);
+  if (custom.length > 0) return custom;
+  const props = {
+    name: (page.metaTitle || page.title || "").trim(),
+    description: (page.metaDescription || "").trim(),
+    image: (meta.og?.image || "").trim(),
+    url: canonical.trim()
+  };
+  const schemaType = meta.schemaType;
+  if (typeof schemaType === "string" && SCHEMA_TYPE_CHOICES.includes(schemaType)) {
+    return [schemaNode(schemaType, props)];
+  }
+  if (page.slug === "home") {
+    return jsonLdNodes(siteSchema).length > 0 ? [] : [schemaNode("WebSite", props)];
+  }
+  return [schemaNode("WebPage", props)];
+}
+function entrySeoInput(entry) {
+  const { metaTitle, metaDescription, noindex, ...metaJson } = entry.seo ?? {};
+  return {
+    title: metaTitle || entry.slug,
+    metaTitle: metaTitle ?? null,
+    metaDescription: metaDescription ?? null,
+    metaJson,
+    noindex: noindex === true
+  };
+}
+function resolveSeo(page, defaults = {}, location = {}) {
+  const meta = page.metaJson ?? {};
+  const title = page.metaTitle || page.title || "";
+  const description = page.metaDescription || defaults.metaDescription || "";
+  const ogImage = meta.og?.image || defaults.og?.image || defaults.ogImage || "";
+  const ogTitle = meta.og?.title || title;
+  const ogDescription = meta.og?.description || description;
+  const twImage = meta.twitter?.image || ogImage;
+  const canonical = meta.canonical || derivedCanonical(location);
+  return {
+    title,
+    description,
+    canonical,
+    og: {
+      title: ogTitle,
+      description: ogDescription,
+      type: meta.og?.type || defaults.og?.type || "website",
+      image: ogImage,
+      url: canonical
+    },
+    twitter: {
+      card: meta.twitter?.card || defaults.twitter?.card || (twImage ? "summary_large_image" : "summary"),
+      title: meta.twitter?.title || ogTitle,
+      description: meta.twitter?.description || ogDescription,
+      image: twImage,
+      site: defaults.twitterHandle || ""
+    },
+    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...pageJsonLd(page, meta, canonical, defaults.siteSchema)],
+    noindex: page.noindex === true,
+    robots: { index: page.noindex !== true, follow: true }
+  };
+}
+export {
+  entrySeoInput,
+  resolveSeo
+};
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/seo.ts"],"sourcesContent":["/**\n * resolveSeo — framework-agnostic page-over-site SEO merge for headless consumers.\n *\n * The single source of truth for \"per-page meta layered over project defaults\",\n * mirroring the server renderer's `mergeSeoMeta` so `*.bettercms.site` and headless\n * sites (@bettercms-ai/next, @bettercms-ai/astro) emit identical <head> SEO. Pure: empty\n * inputs collapse to empty strings (\"omit the tag\"), never fabricated values.\n *\n *   const seo = resolveSeo(page, siteDefaults);\n *   // → { title, description, canonical, og, twitter, jsonLd }\n *\n * Next consumers map this to a `Metadata` via `buildMetadata` (@bettercms-ai/next);\n * Astro consumers read the fields straight into `<head>`.\n */\nimport type { DeliveryEntrySeo, PageMetaJson, SiteSeoDefaults } from \"@bettercms-ai/types\";\n\n/** Minimal page shape `resolveSeo` reads — a `DeliveryPage`/`BetterCMSPage` satisfies it. */\nexport interface SeoInput {\n  title: string;\n  metaTitle?: string | null;\n  metaDescription?: string | null;\n  metaJson?: PageMetaJson | null;\n  /** `\"home\"` makes the Automatic JSON-LD a WebSite, as the hosted renderer does. */\n  slug?: string | null;\n  /** Exclude from search engines. Surfaces as `ResolvedSeo.noindex` / `robots`. */\n  noindex?: boolean | null;\n}\n\n/** Fully-resolved SEO values, page-over-site. Empty string ⇒ omit that tag. */\nexport interface ResolvedSeo {\n  title: string;\n  description: string;\n  /**\n   * Canonical URL — the page's own `canonical`, else `siteUrl` + `path` when both are given,\n   * else \"\". Empty means the consumer must omit the tag: a RELATIVE canonical is worse than\n   * none at all.\n   */\n  canonical: string;\n  og: {\n    title: string;\n    description: string;\n    type: string;\n    image: string;\n    url: string;\n  };\n  twitter: {\n    card: string;\n    title: string;\n    description: string;\n    image: string;\n    site: string;\n  };\n  /**\n   * JSON-LD nodes (site schema first, then the page's), already flattened + de-empted. The page's\n   * part follows the renderer's precedence: Custom (`metaJson.schema`) > `metaJson.schemaType` >\n   * Automatic (WebPage; WebSite on the home page).\n   */\n  jsonLd: Array<Record<string, unknown>>;\n  /** True when the page is excluded from search engines (the renderer's `<meta name=\"robots\" content=\"noindex\">`). */\n  noindex: boolean;\n  /** `noindex` in the `{ index, follow }` shape Next's `Metadata.robots` takes. */\n  robots: { index: boolean; follow: boolean };\n}\n\n/**\n * `siteUrl` + `path` → an absolute canonical, or \"\" when either is missing or unparseable.\n * Never returns a relative URL: a relative canonical is worse than no canonical.\n */\nfunction derivedCanonical({ siteUrl, path }: SeoLocation): string {\n  if (!siteUrl || !path) return \"\";\n  try {\n    return new URL(path, siteUrl.endsWith(\"/\") ? siteUrl : `${siteUrl}/`).toString();\n  } catch {\n    return \"\";\n  }\n}\n\n/** Flatten one-or-many JSON-LD into a node array, dropping empty objects. */\nfunction jsonLdNodes(\n  schema: Record<string, unknown> | Array<Record<string, unknown>> | undefined,\n): Array<Record<string, unknown>> {\n  if (!schema) return [];\n  const arr = Array.isArray(schema) ? schema : [schema];\n  const out: Array<Record<string, unknown>> = [];\n  for (const node of arr) {\n    if (!node || Object.keys(node).length === 0) continue;\n    const graph = node[\"@graph\"];\n    if (Array.isArray(graph)) {\n      for (const child of graph) {\n        if (child && typeof child === \"object\" && !Array.isArray(child) && Object.keys(child).length > 0) {\n          out.push(child as Record<string, unknown>);\n        }\n      }\n      continue;\n    }\n    out.push(node);\n  }\n  return out;\n}\n\n/*\n * Structured data for a page whose `metaJson.schema` is empty. A port of the page path of\n * `resolveStructuredData` in the backend (src/lib/seo/structured-data.ts, called from\n * `pageStructuredData` in src/lib/sites/render-page.ts), with `site.include: false` as the\n * Delivery API calls it: the site-wide schema is emitted separately, from `siteSchema`.\n * A page has no field data, so only the properties the page's own meta supplies are filled.\n * Keep in step with that file; the parity test imports it.\n */\nconst SCHEMA_TYPE_CHOICES = [\n  \"WebPage\",\n  \"AboutPage\",\n  \"ContactPage\",\n  \"CollectionPage\",\n  \"Blog\",\n  \"BlogPosting\",\n  \"Article\",\n  \"Product\",\n  \"FAQPage\",\n  \"Event\",\n  \"Organization\",\n  \"LocalBusiness\",\n] as const;\n\ntype PageProps = { name: string; description: string; image: string; url: string };\n\n/** Drop \"\", null and undefined so a node never carries a blank. */\nfunction compact(node: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(node).filter(([, value]) => value != null && value !== \"\"));\n}\n\nfunction schemaNode(type: string, { name, description, image, url }: PageProps): Record<string, unknown> {\n  switch (type) {\n    case \"BlogPosting\":\n    case \"Article\":\n      return compact({ \"@type\": type, headline: name, description, image, url, mainEntityOfPage: url });\n    case \"Product\":\n    case \"Event\":\n      return compact({ \"@type\": type, name, description, image, url });\n    case \"FAQPage\":\n    case \"WebSite\":\n      return compact({ \"@type\": type, name, description, url });\n    case \"Organization\":\n      return compact({ \"@type\": type, name, description, url, logo: image });\n    default:\n      // WebPage, AboutPage, ContactPage, CollectionPage, Blog, LocalBusiness\n      return compact({ \"@type\": type, name, description, url, image });\n  }\n}\n\n/** The page's own JSON-LD nodes: Custom > explicit `schemaType` > Automatic. */\nfunction pageJsonLd(\n  page: SeoInput,\n  meta: PageMetaJson,\n  canonical: string,\n  siteSchema: SiteSeoDefaults[\"siteSchema\"],\n): Array<Record<string, unknown>> {\n  const custom = jsonLdNodes(meta.schema);\n  if (custom.length > 0) return custom;\n  const props: PageProps = {\n    name: (page.metaTitle || page.title || \"\").trim(),\n    description: (page.metaDescription || \"\").trim(),\n    image: (meta.og?.image || \"\").trim(),\n    url: canonical.trim(),\n  };\n  const schemaType = (meta as { schemaType?: unknown }).schemaType;\n  if (typeof schemaType === \"string\" && (SCHEMA_TYPE_CHOICES as readonly string[]).includes(schemaType)) {\n    return [schemaNode(schemaType, props)];\n  }\n  if (page.slug === \"home\") {\n    // The home page IS the WebSite, unless the site-wide schema already describes it.\n    return jsonLdNodes(siteSchema).length > 0 ? [] : [schemaNode(\"WebSite\", props)];\n  }\n  return [schemaNode(\"WebPage\", props)];\n}\n\n/**\n * A Delivery API entry as a `resolveSeo` input. The server already resolved the collection\n * template's `{{field}}` tokens for this entry and merged the entry's own SEO over it, so this is\n * a reshape, not a resolver:\n *\n *   const entry = await bcms.getEntry(\"astro\");\n *   const seo = resolveSeo(entrySeoInput(entry), siteDefaults, { siteUrl, path: `/tags/${entry.slug}` });\n *   // seo.jsonLd holds the template's schema, resolved for this entry\n */\nexport function entrySeoInput(entry: { slug: string; seo?: DeliveryEntrySeo | null }): SeoInput {\n  const { metaTitle, metaDescription, noindex, ...metaJson } = entry.seo ?? {};\n  return {\n    title: metaTitle || entry.slug,\n    metaTitle: metaTitle ?? null,\n    metaDescription: metaDescription ?? null,\n    metaJson,\n    noindex: noindex === true,\n  };\n}\n\n/** Where this page lives, so a canonical can be derived when the page sets none. */\nexport interface SeoLocation {\n  /** Absolute site origin, e.g. `https://acme.com`. Trailing slash optional. */\n  siteUrl?: string;\n  /** This page's path, e.g. `/about` or `/`. */\n  path?: string;\n}\n\n/**\n * Merge a page's own SEO over the site defaults: page meta wins, then site defaults, then\n * sensible fallbacks.\n *\n * The CANONICAL is the one field that cannot be resolved from content alone, and getting this\n * wrong is silent. The hosted renderer (`mergeSeoMeta` in the backend) falls back to a canonical\n * it derives from the request's own origin and path — headless consumers have no request, so\n * they must pass `location`. Without it this returns \"\" and the caller ships no\n * `<link rel=\"canonical\">` and no `og:url`, exactly as it did before `location` existed.\n */\nexport function resolveSeo(\n  page: SeoInput,\n  defaults: SiteSeoDefaults = {},\n  location: SeoLocation = {},\n): ResolvedSeo {\n  const meta = page.metaJson ?? {};\n  const title = page.metaTitle || page.title || \"\";\n  const description = page.metaDescription || defaults.metaDescription || \"\";\n  const ogImage = meta.og?.image || defaults.og?.image || defaults.ogImage || \"\";\n  const ogTitle = meta.og?.title || title;\n  const ogDescription = meta.og?.description || description;\n  const twImage = meta.twitter?.image || ogImage;\n  const canonical = meta.canonical || derivedCanonical(location);\n  return {\n    title,\n    description,\n    canonical,\n    og: {\n      title: ogTitle,\n      description: ogDescription,\n      type: meta.og?.type || defaults.og?.type || \"website\",\n      image: ogImage,\n      url: canonical,\n    },\n    twitter: {\n      card: meta.twitter?.card || defaults.twitter?.card || (twImage ? \"summary_large_image\" : \"summary\"),\n      title: meta.twitter?.title || ogTitle,\n      description: meta.twitter?.description || ogDescription,\n      image: twImage,\n      site: defaults.twitterHandle || \"\",\n    },\n    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...pageJsonLd(page, meta, canonical, defaults.siteSchema)],\n    noindex: page.noindex === true,\n    robots: { index: page.noindex !== true, follow: true },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettercms-ai/sdk",
-  "version": "1.32.0",
+  "version": "1.34.0",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -15,6 +15,26 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./draft": {
+      "types": "./dist/draft.d.ts",
+      "import": "./dist/draft.js",
+      "default": "./dist/draft.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js",
+      "default": "./dist/config.js"
+    },
+    "./seo": {
+      "types": "./dist/seo.d.ts",
+      "import": "./dist/seo.js",
+      "default": "./dist/seo.js"
+    },
+    "./read": {
+      "types": "./dist/read.d.ts",
+      "import": "./dist/read.js",
+      "default": "./dist/read.js"
     }
   },
   "dependencies": {