@bettercms-ai/sdk 1.36.0 → 1.37.0

package/README.md

@@ -119,6 +119,32 @@ Published reads never carry provenance, whatever `stega` is set to: the payload
 production build. Strip it yourself with `stripStega(value)` if you need the clean string, and
 decode it with `decodeStega(value)`.
 
+## Rich text
+
+A rich-text field arrives as `{ format, value, html }` (or as a bare string, if the field was
+switched from text). Render `html` with `rich()`, or render the structure (`value`) yourself:
+
+```ts
+import { rich, plain, portableText, embeds, resolved } from "@bettercms-ai/sdk";
+
+const entry = await client.getEntry<{ body: RichTextValue }>("launch");
+
+rich(entry.data.body);          // HTML for set:html / dangerouslySetInnerHTML: everything drawn
+plain(entry.data.body);         // text for <title>, meta description, alt
+
+// Rendering the structure with @bettercms-ai/ui (or your own components):
+<PortableText
+  value={portableText(entry.data.body) ?? entry.data.body}
+  embeds={embeds(entry.data.body) ?? undefined}
+  resolved={resolved(entry.data.body, entry) ?? undefined}
+/>;
+```
+
+Related posts and author bios are resolved by the server for each response, from the published
+entries, and never stored. An envelope value carries what it resolved to (`value.resolved`); a
+Body stored as a bare block array cannot, so the entry carries the merged map beside `data`
+(`entry.resolved`). `resolved(value, entry)` returns the value's own map, else the entry's.
+
 ## API
 
 ### `BetterCMS.site(options)`
@@ -127,7 +153,7 @@ decode it with `decodeStega(value)`.
 | --------- | ------ | -------- | -------------------------- |
 | `workspace` | `string` | Yes      | —                          |
 | `apiKey`  | `string` | No       | —                          |
-| `baseUrl` | `string` | No       | `https://api.bettercms.ai/v1` |
+| `baseUrl` | `string` | No       | `https://api.bettercms.ai/api/v1/delivery` |
 
 Returns a `BetterCMSDeliveryClient` instance.
 

package/dist/index.cjs

@@ -110,6 +110,7 @@ __export(index_exports, {
   resetPublishedContentCache: () => resetPublishedContentCache,
   resolveSeo: () => resolveSeo,
   resolveStega: () => resolveStega,
+  resolved: () => resolved,
   revokeApiKey: () => revokeApiKey,
   rich: () => rich,
   search: () => search,
@@ -281,7 +282,7 @@ async function listContent(client, opts) {
     perPage: String(opts?.perPage ?? 20)
   });
   const data = await client.fetchJSON(
-    `${client.url("")}?${params2}`
+    `${client.pagesUrl()}?${params2}`
   );
   return data.data;
 }
@@ -306,7 +307,7 @@ function listContentAll(client, opts) {
           perPage: String(perPage)
         });
         const result = await client.fetchJSON(
-          `${client.url("")}?${params2}`
+          `${client.pagesUrl()}?${params2}`
         );
         const pageData = result.data;
         if (!pageData?.items?.length) break;
@@ -362,6 +363,10 @@ var BetterCMSDeliveryClient = class {
       throw error;
     }
   }
+  /** The published pages list (paginated). */
+  pagesUrl() {
+    return `${this.baseUrl}/${this.workspace}/pages`;
+  }
   /** Build the full URL for a content path. */
   url(path) {
     return `${this.baseUrl}/${this.workspace}/content/${path}`;
@@ -498,7 +503,7 @@ function addWebhookMethods(client, projectId) {
 }
 
 // src/admin-client.ts
-var DEFAULT_BASE_URL = "https://api.bettercms.ai/v1";
+var DEFAULT_BASE_URL = "https://api.bettercms.ai/api/v1";
 var BetterCMSAdminClient = class extends BetterCMSDeliveryClient {
   _token;
   constructor(options) {
@@ -974,7 +979,7 @@ async function publishManagedLayout(client, input) {
 }
 
 // src/management-client.ts
-var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/v1";
+var DEFAULT_BASE_URL2 = "https://api.bettercms.ai/api/v1";
 var DEFAULT_TIMEOUT2 = 1e4;
 var BetterCMSManagementClient = class extends BetterCMSDeliveryClient {
   timeout;
@@ -1254,7 +1259,7 @@ function buildAuthResult(data) {
 }
 
 // src/client.ts
-var DEFAULT_BASE_URL3 = "https://api.bettercms.ai/v1";
+var DEFAULT_BASE_URL3 = "https://api.bettercms.ai/api/v1/delivery";
 var BetterCMS = {
   /**
    * Returns a client for fetching published content.
@@ -1398,7 +1403,7 @@ function createClient(options) {
   return {
     perspective,
     async getEntry(slug, opts) {
-      const url = draft && previewToken ? `${apiUrl}/api/v1/preview/${encodeURIComponent(slug)}${qs({
+      const url = draft && previewToken && tokenSlug(previewToken) === slug ? `${apiUrl}/api/v1/preview/${encodeURIComponent(slug)}${qs({
         token: previewToken,
         depth: opts?.depth,
         select: opts?.select?.join(","),
@@ -1591,6 +1596,14 @@ function embeds(value) {
   const e = value.embeds;
   return typeof e === "object" && e !== null && typeof e.cards === "object" && e.cards !== null ? e : null;
 }
+var resolvedMap = (r) => typeof r === "object" && r !== null && !Array.isArray(r) ? r : null;
+function resolved(value, entry) {
+  const own = isRichText(value) ? resolvedMap(value.resolved) : null;
+  if (own) return own;
+  if (entry) return resolvedMap(entry.resolved);
+  const v = value;
+  return v && typeof v === "object" && !Array.isArray(v) && "data" in v ? resolvedMap(v.resolved) : null;
+}
 function isRichText(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value) && ("html" in value || "format" in value);
 }
@@ -2189,6 +2202,7 @@ function inEditor(win = globalThis.window) {
   resetPublishedContentCache,
   resolveSeo,
   resolveStega,
+  resolved,
   revokeApiKey,
   rich,
   search,