@bettercms-ai/sdk 1.14.0 → 1.16.0

package/README.md

@@ -85,6 +85,40 @@ try {
 }
 ```
 
+## Draft previews and visual editing
+
+A client created with `perspective: "drafts"` reads unpublished content — through a
+`content:read:draft` API key, or through a `previewToken` minted for one document.
+
+Draft reads also carry **stega provenance**: invisible zero-width characters appended to every
+prose value, naming the entry and field it came from. That is what lets the dashboard's canvas
+(and the `<VisualEditing>` overlay) map a rendered string back to its editor without guessing at
+its text. It is **on by default for `perspective: "drafts"` from 1.15.0** — before that it had to
+be asked for, and a preview build that did not know to ask rendered anonymous strings.
+
+```ts
+const draft = createClient({
+  apiUrl,
+  workspace: "my-workspace",
+  apiKey: process.env.BETTERCMS_DRAFT_KEY,
+  perspective: "drafts", // stega is on
+});
+
+// Opt out — e.g. when diffing or checksumming draft content, where the invisible
+// characters would show up as differences.
+const plain = createClient({
+  apiUrl,
+  workspace: "my-workspace",
+  apiKey: process.env.BETTERCMS_DRAFT_KEY,
+  perspective: "drafts",
+  stega: false,
+});
+```
+
+Published reads never carry provenance, whatever `stega` is set to: the payload must not reach a
+production build. Strip it yourself with `stripStega(value)` if you need the clean string, and
+decode it with `decodeStega(value)`.
+
 ## API
 
 ### `BetterCMS.site(options)`

package/dist/index.cjs

@@ -89,6 +89,7 @@ __export(index_exports, {
   listWorkspaces: () => listWorkspaces,
   plain: () => plain,
   portableText: () => portableText,
+  publishManagedLayout: () => publishManagedLayout,
   publishPage: () => publishPage,
   regenerateApiKey: () => regenerateApiKey,
   removeMember: () => removeMember,
@@ -905,6 +906,14 @@ async function commandManagedLayout(client, input) {
   });
   return result.data;
 }
+async function publishManagedLayout(client, input) {
+  const result = await client.fetchJSON(client.url("/management/layout/publish"), {
+    method: "POST",
+    headers: { "If-Match": `W/"${input.ifMatch}"`, ...input.projectId ? { "X-BCMS-Project": input.projectId } : {} },
+    body: JSON.stringify({ scope: "global" })
+  });
+  return result.data;
+}
 
 // src/management-client.ts
 var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/v1";
@@ -1080,13 +1089,16 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   extractComponent(input) {
     return extractComponent(this, input);
   }
-  // ── Layout: draft-only Global/page authoring; publishing remains dashboard-gated. ──
+  // ── Layout: Global/page draft authoring + Global Layout publish (page overrides go live with the page). ──
   getManagedLayout(opts) {
     return getManagedLayout(this, opts);
   }
   commandManagedLayout(input) {
     return commandManagedLayout(this, input);
   }
+  publishManagedLayout(input) {
+    return publishManagedLayout(this, input);
+  }
   // ── AI (Option B): write/rewrite/translate copy + generate SEO meta (BYOK-metered) ──
   /** Write, rewrite, or translate a piece of copy. Returns the suggested text. */
   writeContent(input) {
@@ -1307,6 +1319,7 @@ function createClient(options) {
     throw lastError ?? new BetterCMSError("Unreachable", 0, "NETWORK_ERROR");
   }
   const draft = perspective === "drafts";
+  const stega = options.stega ?? draft;
   return {
     perspective,
     async getEntry(slug, opts) {
@@ -1314,12 +1327,12 @@ function createClient(options) {
         token: previewToken,
         depth: opts?.depth,
         select: opts?.select?.join(","),
-        stega: options.stega ? "1" : void 0
+        stega: stega ? "1" : void 0
       })}` : `${base}/content-entries/${encodeURIComponent(slug)}${qs({
         depth: opts?.depth,
         select: opts?.select?.join(","),
         perspective: draft ? "draft" : void 0,
-        stega: draft && options.stega ? "1" : void 0
+        stega: draft && stega ? "1" : void 0
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1331,7 +1344,7 @@ function createClient(options) {
         depth: opts?.depth,
         select: opts?.select?.join(","),
         perspective: draft ? "draft" : void 0,
-        stega: draft && options.stega ? "1" : void 0
+        stega: draft && stega ? "1" : void 0
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1457,7 +1470,21 @@ function derivedCanonical({ siteUrl, path }) {
 function jsonLdNodes(schema) {
   if (!schema) return [];
   const arr = Array.isArray(schema) ? schema : [schema];
-  return arr.filter((node) => node && Object.keys(node).length > 0);
+  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;
 }
 function resolveSeo(page, defaults = {}, location = {}) {
   const meta = page.metaJson ?? {};
@@ -1861,6 +1888,7 @@ var import_types = require("@bettercms-ai/types");
   listWorkspaces,
   plain,
   portableText,
+  publishManagedLayout,
   publishPage,
   regenerateApiKey,
   removeMember,