@bettercms-ai/sdk 1.32.0 → 1.33.0

package/dist/config.cjs

@@ -0,0 +1,55 @@
+"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/config.ts
+var config_exports = {};
+__export(config_exports, {
+  DEFAULT_MEDIA_URL: () => DEFAULT_MEDIA_URL,
+  resolveBcmsConfig: () => resolveBcmsConfig
+});
+module.exports = __toCommonJS(config_exports);
+var DEFAULT_MEDIA_URL = "https://cdn.bettercms.ai";
+function resolveBcmsConfig(input) {
+  const env = input.env ?? {};
+  const fromEnv = (name) => {
+    for (const p of input.prefixes) {
+      const v = env[`${p}BCMS_${name}`];
+      if (v) return v;
+    }
+    return void 0;
+  };
+  let snap;
+  const snapshot = () => snap ??= input.snapshot?.() ?? {};
+  const o = input.options ?? {};
+  const config = {
+    apiUrl: (o.apiUrl ?? fromEnv("API_URL") ?? snapshot().apiUrl ?? "").replace(/\/+$/, ""),
+    workspace: o.workspace ?? fromEnv("WORKSPACE") ?? snapshot().workspace ?? "",
+    projectId: o.projectId ?? fromEnv("PROJECT_ID") ?? snapshot().projectId,
+    mediaUrl: (o.mediaUrl ?? fromEnv("MEDIA_URL") ?? DEFAULT_MEDIA_URL).replace(/\/+$/, ""),
+    studioUrl: o.studioUrl ?? fromEnv("STUDIO_URL")
+  };
+  const missing = ["apiUrl", "workspace"].filter((k) => !config[k]);
+  return { config, missing };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_MEDIA_URL,
+  resolveBcmsConfig
+});
+//# sourceMappingURL=config.cjs.map

package/dist/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["/**\n * Where a site's BetterCMS settings come from, the same way on every framework: explicit options,\n * then `<PREFIX>BCMS_*` env (each framework exposes env to the browser under its own prefix:\n * `PUBLIC_` for Astro and SvelteKit, `NEXT_PUBLIC_` for Next, `VITE_` for Vite React,\n * `NUXT_PUBLIC_` for Nuxt), then the build snapshot `bettercms pull-content` writes.\n *\n * Pure: the adapter passes its env and reads the snapshot (this module touches no filesystem).\n */\n\nexport const DEFAULT_MEDIA_URL = \"https://cdn.bettercms.ai\";\n\nexport interface BcmsSiteOptions {\n  apiUrl?: string;\n  workspace?: string;\n  projectId?: string;\n  mediaUrl?: string;\n  studioUrl?: string;\n}\n\nexport interface BcmsSiteConfig {\n  apiUrl: string;\n  workspace: string;\n  projectId?: string;\n  mediaUrl: string;\n  studioUrl?: string;\n}\n\nexport interface ResolveBcmsConfigInput {\n  options?: BcmsSiteOptions;\n  env?: Record<string, string | undefined>;\n  /** Env prefixes, first match wins: `[\"NEXT_PUBLIC_\", \"\"]` reads NEXT_PUBLIC_BCMS_API_URL, then BCMS_API_URL. */\n  prefixes: string[];\n  /** The build snapshot's identity, read only when options and env both miss. */\n  snapshot?: () => { apiUrl?: string; workspace?: string; projectId?: string };\n}\n\n/** The resolved settings, and which essentials are missing (the adapter words the error). */\nexport function resolveBcmsConfig(input: ResolveBcmsConfigInput): { config: BcmsSiteConfig; missing: (\"apiUrl\" | \"workspace\")[] } {\n  const env = input.env ?? {};\n  const fromEnv = (name: string) => {\n    for (const p of input.prefixes) {\n      const v = env[`${p}BCMS_${name}`];\n      if (v) return v;\n    }\n    return undefined;\n  };\n  let snap: ReturnType<NonNullable<ResolveBcmsConfigInput[\"snapshot\"]>> | undefined;\n  const snapshot = () => (snap ??= input.snapshot?.() ?? {});\n  const o = input.options ?? {};\n  const config: BcmsSiteConfig = {\n    apiUrl: (o.apiUrl ?? fromEnv(\"API_URL\") ?? snapshot().apiUrl ?? \"\").replace(/\\/+$/, \"\"),\n    workspace: o.workspace ?? fromEnv(\"WORKSPACE\") ?? snapshot().workspace ?? \"\",\n    projectId: o.projectId ?? fromEnv(\"PROJECT_ID\") ?? snapshot().projectId,\n    mediaUrl: (o.mediaUrl ?? fromEnv(\"MEDIA_URL\") ?? DEFAULT_MEDIA_URL).replace(/\\/+$/, \"\"),\n    studioUrl: o.studioUrl ?? fromEnv(\"STUDIO_URL\"),\n  };\n  const missing = ([\"apiUrl\", \"workspace\"] as const).filter((k) => !config[k]);\n  return { config, missing };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAM,oBAAoB;AA4B1B,SAAS,kBAAkB,OAAgG;AAChI,QAAM,MAAM,MAAM,OAAO,CAAC;AAC1B,QAAM,UAAU,CAAC,SAAiB;AAChC,eAAW,KAAK,MAAM,UAAU;AAC9B,YAAM,IAAI,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE;AAChC,UAAI,EAAG,QAAO;AAAA,IAChB;AACA,WAAO;AAAA,EACT;AACA,MAAI;AACJ,QAAM,WAAW,MAAO,SAAS,MAAM,WAAW,KAAK,CAAC;AACxD,QAAM,IAAI,MAAM,WAAW,CAAC;AAC5B,QAAM,SAAyB;AAAA,IAC7B,SAAS,EAAE,UAAU,QAAQ,SAAS,KAAK,SAAS,EAAE,UAAU,IAAI,QAAQ,QAAQ,EAAE;AAAA,IACtF,WAAW,EAAE,aAAa,QAAQ,WAAW,KAAK,SAAS,EAAE,aAAa;AAAA,IAC1E,WAAW,EAAE,aAAa,QAAQ,YAAY,KAAK,SAAS,EAAE;AAAA,IAC9D,WAAW,EAAE,YAAY,QAAQ,WAAW,KAAK,mBAAmB,QAAQ,QAAQ,EAAE;AAAA,IACtF,WAAW,EAAE,aAAa,QAAQ,YAAY;AAAA,EAChD;AACA,QAAM,UAAW,CAAC,UAAU,WAAW,EAAY,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3E,SAAO,EAAE,QAAQ,QAAQ;AAC3B;","names":[]}

package/dist/config.d.cts

@@ -0,0 +1,42 @@
+/**
+ * Where a site's BetterCMS settings come from, the same way on every framework: explicit options,
+ * then `<PREFIX>BCMS_*` env (each framework exposes env to the browser under its own prefix:
+ * `PUBLIC_` for Astro and SvelteKit, `NEXT_PUBLIC_` for Next, `VITE_` for Vite React,
+ * `NUXT_PUBLIC_` for Nuxt), then the build snapshot `bettercms pull-content` writes.
+ *
+ * Pure: the adapter passes its env and reads the snapshot (this module touches no filesystem).
+ */
+declare const DEFAULT_MEDIA_URL = "https://cdn.bettercms.ai";
+interface BcmsSiteOptions {
+    apiUrl?: string;
+    workspace?: string;
+    projectId?: string;
+    mediaUrl?: string;
+    studioUrl?: string;
+}
+interface BcmsSiteConfig {
+    apiUrl: string;
+    workspace: string;
+    projectId?: string;
+    mediaUrl: string;
+    studioUrl?: string;
+}
+interface ResolveBcmsConfigInput {
+    options?: BcmsSiteOptions;
+    env?: Record<string, string | undefined>;
+    /** Env prefixes, first match wins: `["NEXT_PUBLIC_", ""]` reads NEXT_PUBLIC_BCMS_API_URL, then BCMS_API_URL. */
+    prefixes: string[];
+    /** The build snapshot's identity, read only when options and env both miss. */
+    snapshot?: () => {
+        apiUrl?: string;
+        workspace?: string;
+        projectId?: string;
+    };
+}
+/** The resolved settings, and which essentials are missing (the adapter words the error). */
+declare function resolveBcmsConfig(input: ResolveBcmsConfigInput): {
+    config: BcmsSiteConfig;
+    missing: ("apiUrl" | "workspace")[];
+};
+
+export { type BcmsSiteConfig, type BcmsSiteOptions, DEFAULT_MEDIA_URL, type ResolveBcmsConfigInput, resolveBcmsConfig };

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Where a site's BetterCMS settings come from, the same way on every framework: explicit options,
+ * then `<PREFIX>BCMS_*` env (each framework exposes env to the browser under its own prefix:
+ * `PUBLIC_` for Astro and SvelteKit, `NEXT_PUBLIC_` for Next, `VITE_` for Vite React,
+ * `NUXT_PUBLIC_` for Nuxt), then the build snapshot `bettercms pull-content` writes.
+ *
+ * Pure: the adapter passes its env and reads the snapshot (this module touches no filesystem).
+ */
+declare const DEFAULT_MEDIA_URL = "https://cdn.bettercms.ai";
+interface BcmsSiteOptions {
+    apiUrl?: string;
+    workspace?: string;
+    projectId?: string;
+    mediaUrl?: string;
+    studioUrl?: string;
+}
+interface BcmsSiteConfig {
+    apiUrl: string;
+    workspace: string;
+    projectId?: string;
+    mediaUrl: string;
+    studioUrl?: string;
+}
+interface ResolveBcmsConfigInput {
+    options?: BcmsSiteOptions;
+    env?: Record<string, string | undefined>;
+    /** Env prefixes, first match wins: `["NEXT_PUBLIC_", ""]` reads NEXT_PUBLIC_BCMS_API_URL, then BCMS_API_URL. */
+    prefixes: string[];
+    /** The build snapshot's identity, read only when options and env both miss. */
+    snapshot?: () => {
+        apiUrl?: string;
+        workspace?: string;
+        projectId?: string;
+    };
+}
+/** The resolved settings, and which essentials are missing (the adapter words the error). */
+declare function resolveBcmsConfig(input: ResolveBcmsConfigInput): {
+    config: BcmsSiteConfig;
+    missing: ("apiUrl" | "workspace")[];
+};
+
+export { type BcmsSiteConfig, type BcmsSiteOptions, DEFAULT_MEDIA_URL, type ResolveBcmsConfigInput, resolveBcmsConfig };

package/dist/config.js

@@ -0,0 +1,29 @@
+// src/config.ts
+var DEFAULT_MEDIA_URL = "https://cdn.bettercms.ai";
+function resolveBcmsConfig(input) {
+  const env = input.env ?? {};
+  const fromEnv = (name) => {
+    for (const p of input.prefixes) {
+      const v = env[`${p}BCMS_${name}`];
+      if (v) return v;
+    }
+    return void 0;
+  };
+  let snap;
+  const snapshot = () => snap ??= input.snapshot?.() ?? {};
+  const o = input.options ?? {};
+  const config = {
+    apiUrl: (o.apiUrl ?? fromEnv("API_URL") ?? snapshot().apiUrl ?? "").replace(/\/+$/, ""),
+    workspace: o.workspace ?? fromEnv("WORKSPACE") ?? snapshot().workspace ?? "",
+    projectId: o.projectId ?? fromEnv("PROJECT_ID") ?? snapshot().projectId,
+    mediaUrl: (o.mediaUrl ?? fromEnv("MEDIA_URL") ?? DEFAULT_MEDIA_URL).replace(/\/+$/, ""),
+    studioUrl: o.studioUrl ?? fromEnv("STUDIO_URL")
+  };
+  const missing = ["apiUrl", "workspace"].filter((k) => !config[k]);
+  return { config, missing };
+}
+export {
+  DEFAULT_MEDIA_URL,
+  resolveBcmsConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["/**\n * Where a site's BetterCMS settings come from, the same way on every framework: explicit options,\n * then `<PREFIX>BCMS_*` env (each framework exposes env to the browser under its own prefix:\n * `PUBLIC_` for Astro and SvelteKit, `NEXT_PUBLIC_` for Next, `VITE_` for Vite React,\n * `NUXT_PUBLIC_` for Nuxt), then the build snapshot `bettercms pull-content` writes.\n *\n * Pure: the adapter passes its env and reads the snapshot (this module touches no filesystem).\n */\n\nexport const DEFAULT_MEDIA_URL = \"https://cdn.bettercms.ai\";\n\nexport interface BcmsSiteOptions {\n  apiUrl?: string;\n  workspace?: string;\n  projectId?: string;\n  mediaUrl?: string;\n  studioUrl?: string;\n}\n\nexport interface BcmsSiteConfig {\n  apiUrl: string;\n  workspace: string;\n  projectId?: string;\n  mediaUrl: string;\n  studioUrl?: string;\n}\n\nexport interface ResolveBcmsConfigInput {\n  options?: BcmsSiteOptions;\n  env?: Record<string, string | undefined>;\n  /** Env prefixes, first match wins: `[\"NEXT_PUBLIC_\", \"\"]` reads NEXT_PUBLIC_BCMS_API_URL, then BCMS_API_URL. */\n  prefixes: string[];\n  /** The build snapshot's identity, read only when options and env both miss. */\n  snapshot?: () => { apiUrl?: string; workspace?: string; projectId?: string };\n}\n\n/** The resolved settings, and which essentials are missing (the adapter words the error). */\nexport function resolveBcmsConfig(input: ResolveBcmsConfigInput): { config: BcmsSiteConfig; missing: (\"apiUrl\" | \"workspace\")[] } {\n  const env = input.env ?? {};\n  const fromEnv = (name: string) => {\n    for (const p of input.prefixes) {\n      const v = env[`${p}BCMS_${name}`];\n      if (v) return v;\n    }\n    return undefined;\n  };\n  let snap: ReturnType<NonNullable<ResolveBcmsConfigInput[\"snapshot\"]>> | undefined;\n  const snapshot = () => (snap ??= input.snapshot?.() ?? {});\n  const o = input.options ?? {};\n  const config: BcmsSiteConfig = {\n    apiUrl: (o.apiUrl ?? fromEnv(\"API_URL\") ?? snapshot().apiUrl ?? \"\").replace(/\\/+$/, \"\"),\n    workspace: o.workspace ?? fromEnv(\"WORKSPACE\") ?? snapshot().workspace ?? \"\",\n    projectId: o.projectId ?? fromEnv(\"PROJECT_ID\") ?? snapshot().projectId,\n    mediaUrl: (o.mediaUrl ?? fromEnv(\"MEDIA_URL\") ?? DEFAULT_MEDIA_URL).replace(/\\/+$/, \"\"),\n    studioUrl: o.studioUrl ?? fromEnv(\"STUDIO_URL\"),\n  };\n  const missing = ([\"apiUrl\", \"workspace\"] as const).filter((k) => !config[k]);\n  return { config, missing };\n}\n"],"mappings":";AASO,IAAM,oBAAoB;AA4B1B,SAAS,kBAAkB,OAAgG;AAChI,QAAM,MAAM,MAAM,OAAO,CAAC;AAC1B,QAAM,UAAU,CAAC,SAAiB;AAChC,eAAW,KAAK,MAAM,UAAU;AAC9B,YAAM,IAAI,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE;AAChC,UAAI,EAAG,QAAO;AAAA,IAChB;AACA,WAAO;AAAA,EACT;AACA,MAAI;AACJ,QAAM,WAAW,MAAO,SAAS,MAAM,WAAW,KAAK,CAAC;AACxD,QAAM,IAAI,MAAM,WAAW,CAAC;AAC5B,QAAM,SAAyB;AAAA,IAC7B,SAAS,EAAE,UAAU,QAAQ,SAAS,KAAK,SAAS,EAAE,UAAU,IAAI,QAAQ,QAAQ,EAAE;AAAA,IACtF,WAAW,EAAE,aAAa,QAAQ,WAAW,KAAK,SAAS,EAAE,aAAa;AAAA,IAC1E,WAAW,EAAE,aAAa,QAAQ,YAAY,KAAK,SAAS,EAAE;AAAA,IAC9D,WAAW,EAAE,YAAY,QAAQ,WAAW,KAAK,mBAAmB,QAAQ,QAAQ,EAAE;AAAA,IACtF,WAAW,EAAE,aAAa,QAAQ,YAAY;AAAA,EAChD;AACA,QAAM,UAAW,CAAC,UAAU,WAAW,EAAY,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC3E,SAAO,EAAE,QAAQ,QAAQ;AAC3B;","names":[]}

package/dist/draft.cjs

@@ -0,0 +1,86 @@
+"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/draft.ts
+var draft_exports = {};
+__export(draft_exports, {
+  DRAFT_COOKIE: () => DRAFT_COOKIE,
+  decodeTokenSlug: () => decodeTokenSlug,
+  previewTokenValid: () => previewTokenValid,
+  safeRedirectPath: () => safeRedirectPath,
+  signValue: () => signValue,
+  verifyValue: () => verifyValue
+});
+module.exports = __toCommonJS(draft_exports);
+var DRAFT_COOKIE = "bcms-draft";
+var enc = new TextEncoder();
+function base64url(bytes) {
+  const b = btoa(String.fromCharCode(...new Uint8Array(bytes)));
+  return b.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+async function hmac(value, secret) {
+  const key = await crypto.subtle.importKey("raw", enc.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+  return base64url(await crypto.subtle.sign("HMAC", key, enc.encode(value)));
+}
+async function signValue(value, secret) {
+  return `${value}.${await hmac(value, secret)}`;
+}
+async function verifyValue(signed, secret) {
+  const idx = signed.lastIndexOf(".");
+  if (idx < 0) return null;
+  const value = signed.slice(0, idx);
+  const sig = signed.slice(idx + 1);
+  const expected = await hmac(value, secret);
+  if (sig.length !== expected.length) return null;
+  let diff = 0;
+  for (let i = 0; i < sig.length; i++) diff |= sig.charCodeAt(i) ^ expected.charCodeAt(i);
+  return diff === 0 ? value : null;
+}
+function safeRedirectPath(to) {
+  return to.startsWith("/") && !to.startsWith("//") && !to.startsWith("/\\") ? to : "/";
+}
+function decodeTokenSlug(token) {
+  try {
+    const part = token.split(".")[1];
+    if (!part) return null;
+    const bytes = Uint8Array.from(atob(part.replace(/-/g, "+").replace(/_/g, "/")), (c) => c.charCodeAt(0));
+    const json = JSON.parse(new TextDecoder().decode(bytes));
+    return json.entrySlug ?? null;
+  } catch {
+    return null;
+  }
+}
+async function previewTokenValid(apiUrl, token, fetchImpl = fetch) {
+  const slug = decodeTokenSlug(token);
+  if (!slug) return false;
+  const res = await fetchImpl(`${apiUrl.replace(/\/+$/, "")}/api/v1/preview/${encodeURIComponent(slug)}?token=${encodeURIComponent(token)}`);
+  await res.body?.cancel().catch(() => {
+  });
+  return res.ok;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DRAFT_COOKIE,
+  decodeTokenSlug,
+  previewTokenValid,
+  safeRedirectPath,
+  signValue,
+  verifyValue
+});
+//# sourceMappingURL=draft.cjs.map

package/dist/draft.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/draft.ts"],"sourcesContent":["/**\n * Draft mode, shared by every framework adapter: the signed cookie that says \"this visitor is\n * previewing\", the preview token's slug, and the redirect a draft route may follow.\n *\n * Web Crypto and `atob` only, so it runs in Node, edge runtimes and workers alike. Each adapter\n * mounts its own routes around these; the rules live here once.\n */\n\n/** The draft cookie every adapter sets: one name, so an editor link works on any framework. */\nexport const DRAFT_COOKIE = \"bcms-draft\";\n\nconst enc = new TextEncoder();\n\nfunction base64url(bytes: ArrayBuffer): string {\n  const b = btoa(String.fromCharCode(...new Uint8Array(bytes)));\n  return b.replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n}\n\nasync function hmac(value: string, secret: string): Promise<string> {\n  const key = await crypto.subtle.importKey(\"raw\", enc.encode(secret), { name: \"HMAC\", hash: \"SHA-256\" }, false, [\"sign\"]);\n  return base64url(await crypto.subtle.sign(\"HMAC\", key, enc.encode(value)));\n}\n\n/** Sign a value as `value.sig` for tamper-evident cookie storage (HMAC-SHA256, base64url). */\nexport async function signValue(value: string, secret: string): Promise<string> {\n  return `${value}.${await hmac(value, secret)}`;\n}\n\n/** The original value of a signed one, or null when it was tampered with. */\nexport async function verifyValue(signed: string, secret: string): Promise<string | null> {\n  const idx = signed.lastIndexOf(\".\");\n  if (idx < 0) return null;\n  const value = signed.slice(0, idx);\n  const sig = signed.slice(idx + 1);\n  const expected = await hmac(value, secret);\n  if (sig.length !== expected.length) return null;\n  let diff = 0;\n  for (let i = 0; i < sig.length; i++) diff |= sig.charCodeAt(i) ^ expected.charCodeAt(i);\n  return diff === 0 ? value : null;\n}\n\n/** Only same-origin relative paths: blocks \"//evil.com\", \"https://evil.com\" and \"/\\\\evil.com\". */\nexport function safeRedirectPath(to: string): string {\n  return to.startsWith(\"/\") && !to.startsWith(\"//\") && !to.startsWith(\"/\\\\\") ? to : \"/\";\n}\n\n/** A preview token's `entrySlug`, read from its payload UNVERIFIED (the backend verifies it). */\nexport function decodeTokenSlug(token: string): string | null {\n  try {\n    const part = token.split(\".\")[1];\n    if (!part) return null;\n    // atob gives bytes as Latin-1: decoded as UTF-8, a slug like `über-uns` survives.\n    const bytes = Uint8Array.from(atob(part.replace(/-/g, \"+\").replace(/_/g, \"/\")), (c) => c.charCodeAt(0));\n    const json = JSON.parse(new TextDecoder().decode(bytes)) as { entrySlug?: string };\n    return json.entrySlug ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Ask the backend whether a preview token is good: the backend is the signature authority, so a\n * draft route enables draft mode only on its yes.\n */\nexport async function previewTokenValid(apiUrl: string, token: string, fetchImpl: typeof fetch = fetch): Promise<boolean> {\n  const slug = decodeTokenSlug(token);\n  if (!slug) return false;\n  const res = await fetchImpl(`${apiUrl.replace(/\\/+$/, \"\")}/api/v1/preview/${encodeURIComponent(slug)}?token=${encodeURIComponent(token)}`);\n  await res.body?.cancel().catch(() => {});\n  return res.ok;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASO,IAAM,eAAe;AAE5B,IAAM,MAAM,IAAI,YAAY;AAE5B,SAAS,UAAU,OAA4B;AAC7C,QAAM,IAAI,KAAK,OAAO,aAAa,GAAG,IAAI,WAAW,KAAK,CAAC,CAAC;AAC5D,SAAO,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,EAAE;AACpE;AAEA,eAAe,KAAK,OAAe,QAAiC;AAClE,QAAM,MAAM,MAAM,OAAO,OAAO,UAAU,OAAO,IAAI,OAAO,MAAM,GAAG,EAAE,MAAM,QAAQ,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;AACvH,SAAO,UAAU,MAAM,OAAO,OAAO,KAAK,QAAQ,KAAK,IAAI,OAAO,KAAK,CAAC,CAAC;AAC3E;AAGA,eAAsB,UAAU,OAAe,QAAiC;AAC9E,SAAO,GAAG,KAAK,IAAI,MAAM,KAAK,OAAO,MAAM,CAAC;AAC9C;AAGA,eAAsB,YAAY,QAAgB,QAAwC;AACxF,QAAM,MAAM,OAAO,YAAY,GAAG;AAClC,MAAI,MAAM,EAAG,QAAO;AACpB,QAAM,QAAQ,OAAO,MAAM,GAAG,GAAG;AACjC,QAAM,MAAM,OAAO,MAAM,MAAM,CAAC;AAChC,QAAM,WAAW,MAAM,KAAK,OAAO,MAAM;AACzC,MAAI,IAAI,WAAW,SAAS,OAAQ,QAAO;AAC3C,MAAI,OAAO;AACX,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,SAAQ,IAAI,WAAW,CAAC,IAAI,SAAS,WAAW,CAAC;AACtF,SAAO,SAAS,IAAI,QAAQ;AAC9B;AAGO,SAAS,iBAAiB,IAAoB;AACnD,SAAO,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,WAAW,IAAI,KAAK,CAAC,GAAG,WAAW,KAAK,IAAI,KAAK;AACpF;AAGO,SAAS,gBAAgB,OAA8B;AAC5D,MAAI;AACF,UAAM,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AAC/B,QAAI,CAAC,KAAM,QAAO;AAElB,UAAM,QAAQ,WAAW,KAAK,KAAK,KAAK,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACtG,UAAM,OAAO,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,KAAK,CAAC;AACvD,WAAO,KAAK,aAAa;AAAA,EAC3B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,eAAsB,kBAAkB,QAAgB,OAAe,YAA0B,OAAyB;AACxH,QAAM,OAAO,gBAAgB,KAAK;AAClC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,MAAM,UAAU,GAAG,OAAO,QAAQ,QAAQ,EAAE,CAAC,mBAAmB,mBAAmB,IAAI,CAAC,UAAU,mBAAmB,KAAK,CAAC,EAAE;AACzI,QAAM,IAAI,MAAM,OAAO,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AACvC,SAAO,IAAI;AACb;","names":[]}

package/dist/draft.d.cts

@@ -0,0 +1,24 @@
+/**
+ * Draft mode, shared by every framework adapter: the signed cookie that says "this visitor is
+ * previewing", the preview token's slug, and the redirect a draft route may follow.
+ *
+ * Web Crypto and `atob` only, so it runs in Node, edge runtimes and workers alike. Each adapter
+ * mounts its own routes around these; the rules live here once.
+ */
+/** The draft cookie every adapter sets: one name, so an editor link works on any framework. */
+declare const DRAFT_COOKIE = "bcms-draft";
+/** Sign a value as `value.sig` for tamper-evident cookie storage (HMAC-SHA256, base64url). */
+declare function signValue(value: string, secret: string): Promise<string>;
+/** The original value of a signed one, or null when it was tampered with. */
+declare function verifyValue(signed: string, secret: string): Promise<string | null>;
+/** Only same-origin relative paths: blocks "//evil.com", "https://evil.com" and "/\\evil.com". */
+declare function safeRedirectPath(to: string): string;
+/** A preview token's `entrySlug`, read from its payload UNVERIFIED (the backend verifies it). */
+declare function decodeTokenSlug(token: string): string | null;
+/**
+ * Ask the backend whether a preview token is good: the backend is the signature authority, so a
+ * draft route enables draft mode only on its yes.
+ */
+declare function previewTokenValid(apiUrl: string, token: string, fetchImpl?: typeof fetch): Promise<boolean>;
+
+export { DRAFT_COOKIE, decodeTokenSlug, previewTokenValid, safeRedirectPath, signValue, verifyValue };

package/dist/draft.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Draft mode, shared by every framework adapter: the signed cookie that says "this visitor is
+ * previewing", the preview token's slug, and the redirect a draft route may follow.
+ *
+ * Web Crypto and `atob` only, so it runs in Node, edge runtimes and workers alike. Each adapter
+ * mounts its own routes around these; the rules live here once.
+ */
+/** The draft cookie every adapter sets: one name, so an editor link works on any framework. */
+declare const DRAFT_COOKIE = "bcms-draft";
+/** Sign a value as `value.sig` for tamper-evident cookie storage (HMAC-SHA256, base64url). */
+declare function signValue(value: string, secret: string): Promise<string>;
+/** The original value of a signed one, or null when it was tampered with. */
+declare function verifyValue(signed: string, secret: string): Promise<string | null>;
+/** Only same-origin relative paths: blocks "//evil.com", "https://evil.com" and "/\\evil.com". */
+declare function safeRedirectPath(to: string): string;
+/** A preview token's `entrySlug`, read from its payload UNVERIFIED (the backend verifies it). */
+declare function decodeTokenSlug(token: string): string | null;
+/**
+ * Ask the backend whether a preview token is good: the backend is the signature authority, so a
+ * draft route enables draft mode only on its yes.
+ */
+declare function previewTokenValid(apiUrl: string, token: string, fetchImpl?: typeof fetch): Promise<boolean>;
+
+export { DRAFT_COOKIE, decodeTokenSlug, previewTokenValid, safeRedirectPath, signValue, verifyValue };

package/dist/draft.js

@@ -0,0 +1,56 @@
+// src/draft.ts
+var DRAFT_COOKIE = "bcms-draft";
+var enc = new TextEncoder();
+function base64url(bytes) {
+  const b = btoa(String.fromCharCode(...new Uint8Array(bytes)));
+  return b.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+async function hmac(value, secret) {
+  const key = await crypto.subtle.importKey("raw", enc.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+  return base64url(await crypto.subtle.sign("HMAC", key, enc.encode(value)));
+}
+async function signValue(value, secret) {
+  return `${value}.${await hmac(value, secret)}`;
+}
+async function verifyValue(signed, secret) {
+  const idx = signed.lastIndexOf(".");
+  if (idx < 0) return null;
+  const value = signed.slice(0, idx);
+  const sig = signed.slice(idx + 1);
+  const expected = await hmac(value, secret);
+  if (sig.length !== expected.length) return null;
+  let diff = 0;
+  for (let i = 0; i < sig.length; i++) diff |= sig.charCodeAt(i) ^ expected.charCodeAt(i);
+  return diff === 0 ? value : null;
+}
+function safeRedirectPath(to) {
+  return to.startsWith("/") && !to.startsWith("//") && !to.startsWith("/\\") ? to : "/";
+}
+function decodeTokenSlug(token) {
+  try {
+    const part = token.split(".")[1];
+    if (!part) return null;
+    const bytes = Uint8Array.from(atob(part.replace(/-/g, "+").replace(/_/g, "/")), (c) => c.charCodeAt(0));
+    const json = JSON.parse(new TextDecoder().decode(bytes));
+    return json.entrySlug ?? null;
+  } catch {
+    return null;
+  }
+}
+async function previewTokenValid(apiUrl, token, fetchImpl = fetch) {
+  const slug = decodeTokenSlug(token);
+  if (!slug) return false;
+  const res = await fetchImpl(`${apiUrl.replace(/\/+$/, "")}/api/v1/preview/${encodeURIComponent(slug)}?token=${encodeURIComponent(token)}`);
+  await res.body?.cancel().catch(() => {
+  });
+  return res.ok;
+}
+export {
+  DRAFT_COOKIE,
+  decodeTokenSlug,
+  previewTokenValid,
+  safeRedirectPath,
+  signValue,
+  verifyValue
+};
+//# sourceMappingURL=draft.js.map

package/dist/draft.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/draft.ts"],"sourcesContent":["/**\n * Draft mode, shared by every framework adapter: the signed cookie that says \"this visitor is\n * previewing\", the preview token's slug, and the redirect a draft route may follow.\n *\n * Web Crypto and `atob` only, so it runs in Node, edge runtimes and workers alike. Each adapter\n * mounts its own routes around these; the rules live here once.\n */\n\n/** The draft cookie every adapter sets: one name, so an editor link works on any framework. */\nexport const DRAFT_COOKIE = \"bcms-draft\";\n\nconst enc = new TextEncoder();\n\nfunction base64url(bytes: ArrayBuffer): string {\n  const b = btoa(String.fromCharCode(...new Uint8Array(bytes)));\n  return b.replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n}\n\nasync function hmac(value: string, secret: string): Promise<string> {\n  const key = await crypto.subtle.importKey(\"raw\", enc.encode(secret), { name: \"HMAC\", hash: \"SHA-256\" }, false, [\"sign\"]);\n  return base64url(await crypto.subtle.sign(\"HMAC\", key, enc.encode(value)));\n}\n\n/** Sign a value as `value.sig` for tamper-evident cookie storage (HMAC-SHA256, base64url). */\nexport async function signValue(value: string, secret: string): Promise<string> {\n  return `${value}.${await hmac(value, secret)}`;\n}\n\n/** The original value of a signed one, or null when it was tampered with. */\nexport async function verifyValue(signed: string, secret: string): Promise<string | null> {\n  const idx = signed.lastIndexOf(\".\");\n  if (idx < 0) return null;\n  const value = signed.slice(0, idx);\n  const sig = signed.slice(idx + 1);\n  const expected = await hmac(value, secret);\n  if (sig.length !== expected.length) return null;\n  let diff = 0;\n  for (let i = 0; i < sig.length; i++) diff |= sig.charCodeAt(i) ^ expected.charCodeAt(i);\n  return diff === 0 ? value : null;\n}\n\n/** Only same-origin relative paths: blocks \"//evil.com\", \"https://evil.com\" and \"/\\\\evil.com\". */\nexport function safeRedirectPath(to: string): string {\n  return to.startsWith(\"/\") && !to.startsWith(\"//\") && !to.startsWith(\"/\\\\\") ? to : \"/\";\n}\n\n/** A preview token's `entrySlug`, read from its payload UNVERIFIED (the backend verifies it). */\nexport function decodeTokenSlug(token: string): string | null {\n  try {\n    const part = token.split(\".\")[1];\n    if (!part) return null;\n    // atob gives bytes as Latin-1: decoded as UTF-8, a slug like `über-uns` survives.\n    const bytes = Uint8Array.from(atob(part.replace(/-/g, \"+\").replace(/_/g, \"/\")), (c) => c.charCodeAt(0));\n    const json = JSON.parse(new TextDecoder().decode(bytes)) as { entrySlug?: string };\n    return json.entrySlug ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Ask the backend whether a preview token is good: the backend is the signature authority, so a\n * draft route enables draft mode only on its yes.\n */\nexport async function previewTokenValid(apiUrl: string, token: string, fetchImpl: typeof fetch = fetch): Promise<boolean> {\n  const slug = decodeTokenSlug(token);\n  if (!slug) return false;\n  const res = await fetchImpl(`${apiUrl.replace(/\\/+$/, \"\")}/api/v1/preview/${encodeURIComponent(slug)}?token=${encodeURIComponent(token)}`);\n  await res.body?.cancel().catch(() => {});\n  return res.ok;\n}\n"],"mappings":";AASO,IAAM,eAAe;AAE5B,IAAM,MAAM,IAAI,YAAY;AAE5B,SAAS,UAAU,OAA4B;AAC7C,QAAM,IAAI,KAAK,OAAO,aAAa,GAAG,IAAI,WAAW,KAAK,CAAC,CAAC;AAC5D,SAAO,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,GAAG,EAAE,QAAQ,OAAO,EAAE;AACpE;AAEA,eAAe,KAAK,OAAe,QAAiC;AAClE,QAAM,MAAM,MAAM,OAAO,OAAO,UAAU,OAAO,IAAI,OAAO,MAAM,GAAG,EAAE,MAAM,QAAQ,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;AACvH,SAAO,UAAU,MAAM,OAAO,OAAO,KAAK,QAAQ,KAAK,IAAI,OAAO,KAAK,CAAC,CAAC;AAC3E;AAGA,eAAsB,UAAU,OAAe,QAAiC;AAC9E,SAAO,GAAG,KAAK,IAAI,MAAM,KAAK,OAAO,MAAM,CAAC;AAC9C;AAGA,eAAsB,YAAY,QAAgB,QAAwC;AACxF,QAAM,MAAM,OAAO,YAAY,GAAG;AAClC,MAAI,MAAM,EAAG,QAAO;AACpB,QAAM,QAAQ,OAAO,MAAM,GAAG,GAAG;AACjC,QAAM,MAAM,OAAO,MAAM,MAAM,CAAC;AAChC,QAAM,WAAW,MAAM,KAAK,OAAO,MAAM;AACzC,MAAI,IAAI,WAAW,SAAS,OAAQ,QAAO;AAC3C,MAAI,OAAO;AACX,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,IAAK,SAAQ,IAAI,WAAW,CAAC,IAAI,SAAS,WAAW,CAAC;AACtF,SAAO,SAAS,IAAI,QAAQ;AAC9B;AAGO,SAAS,iBAAiB,IAAoB;AACnD,SAAO,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,WAAW,IAAI,KAAK,CAAC,GAAG,WAAW,KAAK,IAAI,KAAK;AACpF;AAGO,SAAS,gBAAgB,OAA8B;AAC5D,MAAI;AACF,UAAM,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC;AAC/B,QAAI,CAAC,KAAM,QAAO;AAElB,UAAM,QAAQ,WAAW,KAAK,KAAK,KAAK,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACtG,UAAM,OAAO,KAAK,MAAM,IAAI,YAAY,EAAE,OAAO,KAAK,CAAC;AACvD,WAAO,KAAK,aAAa;AAAA,EAC3B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,eAAsB,kBAAkB,QAAgB,OAAe,YAA0B,OAAyB;AACxH,QAAM,OAAO,gBAAgB,KAAK;AAClC,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,MAAM,MAAM,UAAU,GAAG,OAAO,QAAQ,QAAQ,EAAE,CAAC,mBAAmB,mBAAmB,IAAI,CAAC,UAAU,mBAAmB,KAAK,CAAC,EAAE;AACzI,QAAM,IAAI,MAAM,OAAO,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AACvC,SAAO,IAAI;AACb;","names":[]}

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
 export { ApiError, ApiKey, ApiKeyPermission, ApiKeyTokenType, AssertEqual, AuthSession, AuthUser, BetterCMSErrorCode, BlockType, ButtonBlock, ButtonProps, ColumnsBlock, ColumnsProps, Content, ContentBlock, ContentEntry, ContentModel, ContentModelField, ContentPageResult, ContentResponse, DeepReadonly, DeliveryComponent, DeliveryEntry, DeliveryList, DeliveryPage, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
+export { ResolvedSeo, SeoInput, SeoLocation, entrySeoInput, resolveSeo } from './seo.cjs';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder, imageValueObjectPosition, imageValueUrl } from '@bettercms-ai/image-url';
 
 /**
@@ -1475,102 +1476,6 @@ declare function rich(value: TextOrRich, fallback?: string): string;
  */
 declare function lines(value: TextOrRich, fallback?: string): string;
 
-/**
- * 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;
-
 /**
  * Public site search — the headless surface for the visitor-facing search box.
  *
@@ -1970,4 +1875,4 @@ interface FramedWindow {
 /** True inside the editor's canvas. Safe where there is no window (a server render): false. */
 declare function inEditor(win?: FramedWindow | undefined): boolean;
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, EDITOR_FRAME_NAME, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type ResolvedSeo, type RichTextValue, STEGA_OPEN, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, contentApplied, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isMultiValueField, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveSeo, resolveStega, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, EDITOR_FRAME_NAME, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type RichTextValue, STEGA_OPEN, type SearchHit, type SearchOptions, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, contentApplied, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isMultiValueField, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveStega, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as _bettercms_ai_types from '@bettercms-ai/types';
-import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, PageMetaJson, DeliveryEntrySeo, SiteSeoDefaults, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
+import { ContentPageResult, Content, DeliveredLayout, ContentModelField, Fieldset, ComponentPreview, BetterCMSErrorCode, LayoutStructureDocument, LayoutDataDocument, PageLayoutOverrideDocument, ManagementLayoutCommand, AuthUser, AuthSession, SignInInput, SignUpInput, Perspective, DeliveryEntry, DeliveryList, DeliveryPage, DeliveryComponent, Page, MediaAsset, FormField, Form, FormSubmission, Workspace, ApiKey, ApiKeyPermission, ApiKeyTokenType } from '@bettercms-ai/types';
 export { ApiError, ApiKey, ApiKeyPermission, ApiKeyTokenType, AssertEqual, AuthSession, AuthUser, BetterCMSErrorCode, BlockType, ButtonBlock, ButtonProps, ColumnsBlock, ColumnsProps, Content, ContentBlock, ContentEntry, ContentModel, ContentModelField, ContentPageResult, ContentResponse, DeepReadonly, DeliveryComponent, DeliveryEntry, DeliveryList, DeliveryPage, Form, FormBlock, FormField, FormProps, FormSubmission, HeadingBlock, HeadingProps, ImageBlock, ImageProps, MediaAsset, Page, PageMetaJson, PaginatedResult, Perspective, Redirect, SignInInput, SignUpInput, SiteSeoDefaults, SpacerBlock, SpacerProps, TextBlock, TextProps, VideoBlock, VideoProps, Workspace, getBlockType, isBlock } from '@bettercms-ai/types';
+export { ResolvedSeo, SeoInput, SeoLocation, entrySeoInput, resolveSeo } from './seo.js';
 export { ImageFit, ImageFormat, ImageSource, ImageUrlBuilder, ImageUrlOptions, imageUrl, default as imageUrlBuilder, imageValueObjectPosition, imageValueUrl } from '@bettercms-ai/image-url';
 
 /**
@@ -1475,102 +1476,6 @@ declare function rich(value: TextOrRich, fallback?: string): string;
  */
 declare function lines(value: TextOrRich, fallback?: string): string;
 
-/**
- * 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;
-
 /**
  * Public site search — the headless surface for the visitor-facing search box.
  *
@@ -1970,4 +1875,4 @@ interface FramedWindow {
 /** True inside the editor's canvas. Safe where there is no window (a server render): false. */
 declare function inEditor(win?: FramedWindow | undefined): boolean;
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, EDITOR_FRAME_NAME, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type ResolvedSeo, type RichTextValue, STEGA_OPEN, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, contentApplied, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isMultiValueField, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveSeo, resolveStega, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, EDITOR_FRAME_NAME, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type RichTextValue, STEGA_OPEN, type SearchHit, type SearchOptions, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, contentApplied, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inEditor, inviteMember, isMultiValueField, isRichText, lines, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveStega, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

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.33.0",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -15,6 +15,21 @@
       "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"
     }
   },
   "dependencies": {