@bettercms-ai/sdk 1.10.0 → 1.12.0

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(index_exports, {
   addModelFields: () => addModelFields,
   addPageFields: () => addPageFields,
   asStringArray: () => asStringArray,
+  commandManagedLayout: () => commandManagedLayout,
   createApiKey: () => createApiKey,
   createClient: () => createClient,
   createEntry: () => createEntry,
@@ -61,6 +62,7 @@ __export(index_exports, {
   getBlockType: () => import_types.getBlockType,
   getEntry: () => getEntry,
   getForm: () => getForm2,
+  getManagedLayout: () => getManagedLayout,
   getManagedPage: () => getManagedPage,
   getMedia: () => getMedia,
   getMember: () => getMember,
@@ -285,6 +287,15 @@ var BetterCMSDeliveryClient = class {
   listContentAll(opts) {
     return listContentAll(this, opts);
   }
+  async getLayout() {
+    try {
+      const result = await this.fetchJSON(`${this.baseUrl}/${this.workspace}/layout`);
+      return result.data;
+    } catch (error) {
+      if (error instanceof BetterCMSError && error.status === 404) return null;
+      throw error;
+    }
+  }
   /** Build the full URL for a content path. */
   url(path) {
     return `${this.baseUrl}/${this.workspace}/content/${path}`;
@@ -778,6 +789,21 @@ async function createComponent(client, input) {
   });
   return res.data;
 }
+async function listExtractionCandidates(client, projectId) {
+  const qs3 = projectId ? `?projectId=${encodeURIComponent(projectId)}` : "";
+  const res = await client.fetchJSON(
+    client.url(`/management/components/extraction-candidates${qs3}`),
+    { method: "GET" }
+  );
+  return res.data;
+}
+async function extractComponent(client, input) {
+  const res = await client.fetchJSON(
+    client.url("/management/components/extract"),
+    { method: "POST", body: JSON.stringify(input) }
+  );
+  return { component: res.data, replaced: res.replaced };
+}
 async function updateComponent(client, id, input) {
   const res = await client.fetchJSON(
     client.url(`/management/components/${id}`),
@@ -802,6 +828,27 @@ async function generateSeoMeta(client, input) {
   return res.data;
 }
 
+// src/methods/management/layout.ts
+async function getManagedLayout(client, opts) {
+  const query = new URLSearchParams();
+  if (opts?.scope) query.set("scope", opts.scope);
+  if (opts?.pageId) query.set("pageId", opts.pageId);
+  const result = await client.fetchJSON(
+    client.url(`/management/layout${query.size ? `?${query}` : ""}`),
+    opts?.projectId ? { headers: { "X-BCMS-Project": opts.projectId } } : void 0
+  );
+  return result.data;
+}
+async function commandManagedLayout(client, input) {
+  const { ifMatch, projectId, ...body } = input;
+  const result = await client.fetchJSON(client.url("/management/layout/commands"), {
+    method: "POST",
+    headers: { "If-Match": `W/"${ifMatch}"`, ...projectId ? { "X-BCMS-Project": projectId } : {} },
+    body: JSON.stringify(body)
+  });
+  return result.data;
+}
+
 // src/management-client.ts
 var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/v1";
 var DEFAULT_TIMEOUT2 = 1e4;
@@ -966,6 +1013,21 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   updateComponent(id, input) {
     return updateComponent(this, id, input);
   }
+  /** Sections repeating across the project's pages, proposed as components. */
+  listExtractionCandidates(projectId) {
+    return listExtractionCandidates(this, projectId);
+  }
+  /** Fold one candidate into a component and repoint every occurrence at it. */
+  extractComponent(input) {
+    return extractComponent(this, input);
+  }
+  // ── Layout: draft-only Global/page authoring; publishing remains dashboard-gated. ──
+  getManagedLayout(opts) {
+    return getManagedLayout(this, opts);
+  }
+  commandManagedLayout(input) {
+    return commandManagedLayout(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) {
@@ -1171,16 +1233,17 @@ function createClient(options) {
   return {
     perspective,
     async getEntry(slug, opts) {
-      const query = qs({
-        depth: opts?.depth,
-        select: opts?.select?.join(",")
-      });
       const url = draft && previewToken ? `${apiUrl}/api/v1/preview/${encodeURIComponent(slug)}${qs({
         token: previewToken,
         depth: opts?.depth,
         select: opts?.select?.join(","),
         stega: options.stega ? "1" : void 0
-      })}` : `${base}/content-entries/${encodeURIComponent(slug)}${query}`;
+      })}` : `${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
+      })}`;
       return unwrap(await fetchJSON(url));
     },
     async listEntries(opts) {
@@ -1189,7 +1252,9 @@ function createClient(options) {
         page: opts?.page,
         perPage: opts?.perPage,
         depth: opts?.depth,
-        select: opts?.select?.join(",")
+        select: opts?.select?.join(","),
+        perspective: draft ? "draft" : void 0,
+        stega: draft && options.stega ? "1" : void 0
       })}`;
       return unwrap(await fetchJSON(url));
     },
@@ -1210,6 +1275,15 @@ function createClient(options) {
       })}`;
       return unwrap(await fetchJSON(url));
     },
+    async getLayout() {
+      const url = `${base}/layout${draft ? "?perspective=draft" : ""}`;
+      try {
+        return unwrap(await fetchJSON(url));
+      } catch (error) {
+        if (error instanceof BetterCMSError && error.status === 404) return null;
+        throw error;
+      }
+    },
     async listForms(opts) {
       const url = `${base}/forms${qs({
         projectId: opts?.projectId ?? defaultProjectId
@@ -1648,6 +1722,7 @@ var import_types = require("@bettercms-ai/types");
   addModelFields,
   addPageFields,
   asStringArray,
+  commandManagedLayout,
   createApiKey,
   createClient,
   createEntry,
@@ -1668,6 +1743,7 @@ var import_types = require("@bettercms-ai/types");
   getBlockType,
   getEntry,
   getForm,
+  getManagedLayout,
   getManagedPage,
   getMedia,
   getMember,