@bettercms-ai/sdk 1.26.1 → 1.26.3

package/dist/index.d.cts

@@ -633,6 +633,16 @@ declare function isMultiValueField(type: DeliveryFormFieldType): boolean;
 interface DeliveryForm {
     id: string;
     name: string;
+    /** The project the form belongs to. */
+    projectId?: string | null;
+    /**
+     * A `draft` form refuses every submission: render it as unavailable rather than as a form that
+     * silently drops what a visitor sends. Delivered for exactly that reason, and missing from this
+     * type until the contract test held the two together.
+     */
+    status?: "draft" | "published" | (string & {});
+    /** Set on a form the site's owner told BetterCMS to leave alone (ISO time); such a form is not wired. */
+    ignoredAt?: string | null;
     fields: DeliveryFormField[];
     submitLabel?: string;
     successMessage?: string;
@@ -1487,7 +1497,7 @@ declare function search(opts: SearchOptions): Promise<SearchHit[]>;
  * `import.meta.glob`) and the bundle holds a frozen copy no publish can reach: the platform then
  * has to rebuild the whole site for every edit.
  *
- * - On a hosted server: `BCMS_CONTENT_FILE`, re-read when it changes (checked at most once a second).
+ * - On a hosted server: `BCMS_CONTENT_FILE`, re-read when it changes (its time is asked on every call).
  * - At build time and in local dev: `<cwd>/bcms-content.json`, the snapshot the build was given.
  * - Anywhere without a filesystem (a browser, an edge runtime): `null`.
  *
@@ -1500,9 +1510,14 @@ interface PublishedContent {
     apiUrl?: string | null;
     workspace?: string;
     projectId?: string | null;
-    /** Published entries by model slug; each row carries its own `slug` and its field values. */
+    /**
+     * Published entries by model slug, each row AS THE DELIVERY API SERVES IT: `id`, `slug`, `status`,
+     * `publishedAt`, `updatedAt`, `locale`, `translationOf`, `_meta`, and the field values under
+     * `data`. Read a value through {@link publishedEntry}, which answers either spelling.
+     */
     collections?: Record<string, Array<Record<string, unknown> & {
         slug?: string;
+        data?: Record<string, unknown>;
     }>>;
     pages?: unknown[];
     components?: unknown[];
@@ -1520,6 +1535,14 @@ declare function readPublishedContent<T extends PublishedContent = PublishedCont
 /**
  * One published entry by its slug, searched across every collection (first match wins, in the
  * snapshot's model order). Not keyed by model slug: a page's backing model is named by the CMS.
+ *
+ * 🔴 THE VALUES ARE ON THE ENTRY: `publishedEntry("home")?.title`. The snapshot holds each row as
+ * the delivery API serves it, values under `data`, and this used to hand that row back as it was
+ * while its own doc (and the skill that names it) said "the row carries its field values" — so
+ * `entry.title` was `undefined` and every field of a server-rendered page fell back to the copy in
+ * the code, on every publish. Both spellings are answered: the values at the top level and the
+ * row's own keys (`id`, `slug`, `status`, `data`, `_meta`, …) beside them, the row's winning where
+ * a field is named like one — that field is read through `.data`, as before.
  */
 declare function publishedEntry<T extends Record<string, unknown> = Record<string, unknown>>(slug: string): (T & {
     slug: string;

package/dist/index.d.ts

@@ -633,6 +633,16 @@ declare function isMultiValueField(type: DeliveryFormFieldType): boolean;
 interface DeliveryForm {
     id: string;
     name: string;
+    /** The project the form belongs to. */
+    projectId?: string | null;
+    /**
+     * A `draft` form refuses every submission: render it as unavailable rather than as a form that
+     * silently drops what a visitor sends. Delivered for exactly that reason, and missing from this
+     * type until the contract test held the two together.
+     */
+    status?: "draft" | "published" | (string & {});
+    /** Set on a form the site's owner told BetterCMS to leave alone (ISO time); such a form is not wired. */
+    ignoredAt?: string | null;
     fields: DeliveryFormField[];
     submitLabel?: string;
     successMessage?: string;
@@ -1487,7 +1497,7 @@ declare function search(opts: SearchOptions): Promise<SearchHit[]>;
  * `import.meta.glob`) and the bundle holds a frozen copy no publish can reach: the platform then
  * has to rebuild the whole site for every edit.
  *
- * - On a hosted server: `BCMS_CONTENT_FILE`, re-read when it changes (checked at most once a second).
+ * - On a hosted server: `BCMS_CONTENT_FILE`, re-read when it changes (its time is asked on every call).
  * - At build time and in local dev: `<cwd>/bcms-content.json`, the snapshot the build was given.
  * - Anywhere without a filesystem (a browser, an edge runtime): `null`.
  *
@@ -1500,9 +1510,14 @@ interface PublishedContent {
     apiUrl?: string | null;
     workspace?: string;
     projectId?: string | null;
-    /** Published entries by model slug; each row carries its own `slug` and its field values. */
+    /**
+     * Published entries by model slug, each row AS THE DELIVERY API SERVES IT: `id`, `slug`, `status`,
+     * `publishedAt`, `updatedAt`, `locale`, `translationOf`, `_meta`, and the field values under
+     * `data`. Read a value through {@link publishedEntry}, which answers either spelling.
+     */
     collections?: Record<string, Array<Record<string, unknown> & {
         slug?: string;
+        data?: Record<string, unknown>;
     }>>;
     pages?: unknown[];
     components?: unknown[];
@@ -1520,6 +1535,14 @@ declare function readPublishedContent<T extends PublishedContent = PublishedCont
 /**
  * One published entry by its slug, searched across every collection (first match wins, in the
  * snapshot's model order). Not keyed by model slug: a page's backing model is named by the CMS.
+ *
+ * 🔴 THE VALUES ARE ON THE ENTRY: `publishedEntry("home")?.title`. The snapshot holds each row as
+ * the delivery API serves it, values under `data`, and this used to hand that row back as it was
+ * while its own doc (and the skill that names it) said "the row carries its field values" — so
+ * `entry.title` was `undefined` and every field of a server-rendered page fell back to the copy in
+ * the code, on every publish. Both spellings are answered: the values at the top level and the
+ * row's own keys (`id`, `slug`, `status`, `data`, `_meta`, …) beside them, the row's winning where
+ * a field is named like one — that field is read through `.data`, as before.
  */
 declare function publishedEntry<T extends Record<string, unknown> = Record<string, unknown>>(slug: string): (T & {
     slug: string;

package/dist/index.js

@@ -1568,7 +1568,6 @@ async function search(opts) {
 
 // src/published-content.ts
 var cache = null;
-var checkedAt = 0;
 function publishedContentFile() {
   const proc = globalThis.process;
   if (typeof proc?.getBuiltinModule !== "function") return null;
@@ -1577,9 +1576,6 @@ function publishedContentFile() {
 function readPublishedContent() {
   const file = publishedContentFile();
   if (!file) return null;
-  const now = Date.now();
-  if (cache && cache.file === file && now - checkedAt < 1e3) return cache.content;
-  checkedAt = now;
   const proc = globalThis.process;
   const fs = proc.getBuiltinModule("node:fs");
   try {
@@ -1591,18 +1587,23 @@ function readPublishedContent() {
   }
   return cache.content;
 }
+var flat = /* @__PURE__ */ new WeakMap();
 function publishedEntry(slug) {
   const collections = readPublishedContent()?.collections ?? {};
   for (const rows of Object.values(collections)) {
     if (!Array.isArray(rows)) continue;
     const hit = rows.find((row) => row?.slug === slug);
-    if (hit) return hit;
+    if (!hit) continue;
+    const data = hit.data;
+    if (!data || typeof data !== "object" || Array.isArray(data)) return hit;
+    let entry = flat.get(hit);
+    if (!entry) flat.set(hit, entry = { ...data, ...hit });
+    return entry;
   }
   return null;
 }
 function resetPublishedContentCache() {
   cache = null;
-  checkedAt = 0;
 }
 
 // src/index.ts