@bettercms-ai/sdk 1.8.0 → 1.9.0

package/dist/index.cjs

@@ -71,6 +71,7 @@ __export(index_exports, {
   imageUrlBuilder: () => import_image_url.default,
   inviteMember: () => inviteMember,
   isBlock: () => import_types.isBlock,
+  isRichText: () => isRichText,
   listApiKeys: () => listApiKeys,
   listEntries: () => listEntries,
   listForms: () => listForms2,
@@ -81,11 +82,13 @@ __export(index_exports, {
   listPages: () => listPages,
   listSubmissions: () => listSubmissions,
   listWorkspaces: () => listWorkspaces,
+  plain: () => plain,
   publishPage: () => publishPage,
   regenerateApiKey: () => regenerateApiKey,
   removeMember: () => removeMember,
   resolveSeo: () => resolveSeo,
   revokeApiKey: () => revokeApiKey,
+  rich: () => rich,
   search: () => search,
   setPageContent: () => setPageContent,
   shouldShowField: () => shouldShowField,
@@ -136,12 +139,20 @@ var BetterCMSError = class _BetterCMSError extends Error {
    * shares a status with others (e.g. 409 slug-conflict vs 409 project-deleted).
    */
   bodyCode;
-  constructor(message, status, code, bodyCode) {
+  /**
+   * Per-field validation messages from a 400 `{ errors: { field: message } }` body.
+   * The backend returns validation failures in this shape (not `message`/`error`), so
+   * without this the SDK collapsed every validation 400 to a bare "Bad Request" with no
+   * hint which field or rule failed (FLO-474). Mirrors the forms client's `fieldErrors`.
+   */
+  fieldErrors;
+  constructor(message, status, code, bodyCode, fieldErrors) {
     super(message);
     this.name = "BetterCMSError";
     this.status = status;
     this.code = code;
     this.bodyCode = bodyCode;
+    this.fieldErrors = fieldErrors;
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, _BetterCMSError);
     }
@@ -152,25 +163,40 @@ var BetterCMSError = class _BetterCMSError extends Error {
       message: this.message,
       status: this.status,
       code: this.code,
-      bodyCode: this.bodyCode
+      bodyCode: this.bodyCode,
+      fieldErrors: this.fieldErrors
     };
   }
   /**
-   * Factory — creates a BetterCMSError from a failed fetch Response. Reads the
-   * body's `message` (or `error`) for the human message and `code` for a
-   * machine-readable condition the SDK surfaces as `bodyCode`.
+   * Factory — creates a BetterCMSError from a failed fetch Response. Reads the body's
+   * `message` (or `error`) for the human message and `code` for a machine-readable
+   * condition surfaced as `bodyCode`. Validation failures arrive as `{ errors: {...} }`
+   * (no `message`/`error`), so fall back to the first field error for the message and
+   * expose the full map as `fieldErrors` (FLO-474).
    */
   static async from(res) {
     let message = res.statusText || "An error occurred";
     let bodyCode;
+    let fieldErrors;
+    let code = statusToCode(res.status);
     try {
       const body = await res.json();
+      if (body?.errors && typeof body.errors === "object") {
+        fieldErrors = body.errors;
+        code = ErrorCodes.VALIDATION_ERROR;
+      }
       if (body?.message) message = body.message;
       else if (body?.error) message = body.error;
+      else if (fieldErrors) {
+        const [field, detail] = Object.entries(fieldErrors).find(
+          ([, v]) => typeof v === "string" && v.length > 0
+        ) ?? [];
+        if (field) message = `${field}: ${detail}`;
+      }
       if (body?.code) bodyCode = body.code;
     } catch {
     }
-    return new _BetterCMSError(message, res.status, statusToCode(res.status), bodyCode);
+    return new _BetterCMSError(message, res.status, code, bodyCode, fieldErrors);
   }
 };
 
@@ -1235,6 +1261,30 @@ function stripStega(value) {
   return value.replace(FRAME, "");
 }
 
+// src/richtext.ts
+function isRichText(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && ("html" in value || "format" in value);
+}
+function plain(value) {
+  if (typeof value === "string") return value;
+  if (!isRichText(value) || typeof value.html !== "string") return "";
+  return decodeEntities(value.html.replace(/<[^>]+>/g, "")).trim();
+}
+function rich(value, fallback = "") {
+  const html = (typeof value === "string" ? escapeHtml(value) : isRichText(value) ? value.html ?? "" : "").trim();
+  return html ? unwrapLoneBlock(html) : escapeHtml(fallback);
+}
+function unwrapLoneBlock(html) {
+  const m = html.match(/^<(p|div|h[1-6])(?:\s[^>]*)?>([\s\S]*)<\/\1>$/i);
+  return m && !new RegExp(`</${m[1]}>`, "i").test(m[2]) ? m[2] : html;
+}
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function decodeEntities(s) {
+  return s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#0?39;/g, "'").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&");
+}
+
 // src/seo.ts
 function jsonLdNodes(schema) {
   if (!schema) return [];
@@ -1608,6 +1658,7 @@ var import_types = require("@bettercms-ai/types");
   imageUrlBuilder,
   inviteMember,
   isBlock,
+  isRichText,
   listApiKeys,
   listEntries,
   listForms,
@@ -1618,11 +1669,13 @@ var import_types = require("@bettercms-ai/types");
   listPages,
   listSubmissions,
   listWorkspaces,
+  plain,
   publishPage,
   regenerateApiKey,
   removeMember,
   resolveSeo,
   revokeApiKey,
+  rich,
   search,
   setPageContent,
   shouldShowField,