@bettercms-ai/sdk 1.17.0 → 1.19.0

package/dist/index.cjs

@@ -154,13 +154,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 +198,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 +214,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);
   }
 };
 
@@ -825,9 +838,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;
@@ -1068,9 +1082,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);
@@ -1249,6 +1262,16 @@ function unwrap(json) {
   }
   return json;
 }
+function tokenSlug(token) {
+  try {
+    const part = token.split(".")[1];
+    if (!part) return null;
+    const json = atob(part.replace(/-/g, "+").replace(/_/g, "/"));
+    return JSON.parse(json).entrySlug ?? null;
+  } catch {
+    return null;
+  }
+}
 function createRequestCache() {
   const inflight = /* @__PURE__ */ new Map();
   const settled = /* @__PURE__ */ new Map();
@@ -1349,6 +1372,23 @@ function createClient(options) {
       return unwrap(await fetchJSON(url));
     },
     async getPage(slug) {
+      if (draft && previewToken && tokenSlug(previewToken) === slug) {
+        const url = `${apiUrl}/api/v1/preview/${encodeURIComponent(slug)}${qs({
+          token: previewToken,
+          stega: stega ? "1" : void 0
+        })}`;
+        const d = unwrap(await fetchJSON(url));
+        return {
+          slug: d.slug,
+          title: d.title,
+          metaTitle: d.metaTitle ?? null,
+          metaDescription: d.metaDescription ?? null,
+          metaJson: d.metaJson ?? null,
+          blocks: d.blockJson ?? [],
+          updatedAt: d.updatedAt ?? null,
+          publishedAt: d.publishedAt ?? null
+        };
+      }
       let page = 1;
       for (; ; ) {
         const list = await this.listPages({ page, perPage: 100 });
@@ -1365,6 +1405,13 @@ function createClient(options) {
       })}`;
       return unwrap(await fetchJSON(url));
     },
+    async listComponents() {
+      const url = `${base}/components${qs({
+        perspective: draft ? "draft" : void 0,
+        token: draft ? previewToken : void 0
+      })}`;
+      return unwrap(await fetchJSON(url));
+    },
     async getLayout() {
       const url = `${base}/layout${draft ? "?perspective=draft" : ""}`;
       try {