@bettercms-ai/sdk 1.18.0 → 1.20.0

package/dist/index.cjs

@@ -58,6 +58,7 @@ __export(index_exports, {
   deleteSubmission: () => deleteSubmission,
   deleteWorkspace: () => deleteWorkspace,
   encodeStega: () => encodeStega,
+  entrySeoInput: () => entrySeoInput,
   formInitialValues: () => formInitialValues,
   getApiKeyUsage: () => getApiKeyUsage,
   getBlockType: () => import_types.getBlockType,
@@ -154,13 +155,24 @@ var BetterCMSError = class _BetterCMSError extends Error {
    * hint which field or rule failed (FLO-474). Mirrors the forms client's `fieldErrors`.
    */
   fieldErrors;
-  constructor(message, status, code, bodyCode, fieldErrors) {
+  /**
+   * The parsed response body, when there was one.
+   *
+   * Several refusals carry STRUCTURED detail that neither `message` nor `fieldErrors` can hold,
+   * and which is the whole point of the refusal: a component publish 409s with the full
+   * `readiness` tuple (what evidence is missing, whether a human still has to approve it) and
+   * 422s with the `issues` naming the Layouts it would break. Collapsing those to a sentence
+   * leaves a caller able to report that something failed and not what to do about it.
+   */
+  body;
+  constructor(message, status, code, bodyCode, fieldErrors, body) {
     super(message);
     this.name = "BetterCMSError";
     this.status = status;
     this.code = code;
     this.bodyCode = bodyCode;
     this.fieldErrors = fieldErrors;
+    this.body = body;
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, _BetterCMSError);
     }
@@ -187,6 +199,7 @@ var BetterCMSError = class _BetterCMSError extends Error {
     let bodyCode;
     let fieldErrors;
     let code = statusToCode(res.status);
+    let raw;
     try {
       const body = await res.json();
       if (body?.errors && typeof body.errors === "object") {
@@ -202,9 +215,10 @@ var BetterCMSError = class _BetterCMSError extends Error {
         if (field) message = `${field}: ${detail}`;
       }
       if (body?.code) bodyCode = body.code;
+      raw = body;
     } catch {
     }
-    return new _BetterCMSError(message, res.status, code, bodyCode, fieldErrors);
+    return new _BetterCMSError(message, res.status, code, bodyCode, fieldErrors, raw);
   }
 };
 
@@ -664,6 +678,13 @@ async function deleteModel(client, id) {
 }
 
 // src/methods/management/media.ts
+async function updateAsset(client, id, input) {
+  const { data } = await client.fetchJSON(
+    client.url(`/management/media/${encodeURIComponent(id)}`),
+    { method: "PATCH", body: JSON.stringify(input) }
+  );
+  return data;
+}
 var MIME_BY_EXT = {
   png: "image/png",
   jpg: "image/jpeg",
@@ -791,6 +812,10 @@ async function uploadAsset(client, input) {
       body: bytes
     }
   );
+  if (input.transcript && input.transcript.trim()) {
+    await updateAsset(client, data.id, { transcript: input.transcript });
+    return { ...data, transcript: input.transcript };
+  }
   return data;
 }
 
@@ -825,9 +850,10 @@ async function updateForm(client, id, input) {
 }
 
 // src/methods/management/components.ts
-async function listComponents(client) {
+async function listComponents(client, options) {
+  const query = options?.select ? `?select=${options.select}` : "";
   const res = await client.fetchJSON(
-    client.url("/management/components"),
+    client.url(`/management/components${query}`),
     { method: "GET" }
   );
   return res.data;
@@ -1051,6 +1077,10 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   uploadAsset(input) {
     return uploadAsset(this, input);
   }
+  /** Set an asset's alt text, caption or transcript (video/audio only). `null` clears. */
+  updateAsset(id, input) {
+    return updateAsset(this, id, input);
+  }
   // ── Forms (read-only): discover dashboard-built forms to embed into site code ──
   /** List forms in the key's project (or workspace-level). */
   listForms() {
@@ -1068,9 +1098,8 @@ var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   updateForm(id, input) {
     return updateForm(this, id, input);
   }
-  // ── Components: discover + author reusable symbols ──
-  listComponents() {
-    return listComponents(this);
+  listComponents(options) {
+    return options?.select ? listComponents(this, { select: options.select }) : listComponents(this);
   }
   getComponent(id) {
     return getComponent(this, id);
@@ -1520,6 +1549,68 @@ function jsonLdNodes(schema) {
   }
   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 || "";
@@ -1547,7 +1638,9 @@ function resolveSeo(page, defaults = {}, location = {}) {
       image: twImage,
       site: defaults.twitterHandle || ""
     },
-    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...jsonLdNodes(meta.schema)]
+    jsonLd: [...jsonLdNodes(defaults.siteSchema), ...pageJsonLd(page, meta, canonical, defaults.siteSchema)],
+    noindex: page.noindex === true,
+    robots: { index: page.noindex !== true, follow: true }
   };
 }
 
@@ -1891,6 +1984,7 @@ var import_types = require("@bettercms-ai/types");
   deleteSubmission,
   deleteWorkspace,
   encodeStega,
+  entrySeoInput,
   formInitialValues,
   getApiKeyUsage,
   getBlockType,