@wix/himalaya-cli 0.1145.0 → 0.1147.0

package/templates/nonprofit-cause/tier5-src/himi-events-detail/index.ts

@@ -35,6 +35,8 @@ import {
 } from "../_shared/himi-events";
 import { initials } from "../_shared/himi-text.js";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
+import { openRichLink } from "../_shared/rich-content-link.js";
+import { richBody } from "../_shared/rich-body.js";
 
 interface MapMarker {
   latitude: number;
@@ -88,7 +90,13 @@ interface S {
   initial: string;
   when: string;
   location: string;
+  /** The plain-text description: RichContent's fallback, the calendar notes, and what shows with no document. */
   description: string;
+  /** [rico] #3372 — the v3 Ricos `description` (read with `fields=TEXTS`) as ONE document string for
+   *  RichContent; "" when the event has none or the encoder rejected it. */
+  descriptionJson: string;
+  /** descriptionJson !== "" — gates the plain text, because RichContent draws nothing for "". */
+  hasDescriptionJson: boolean;
   image: string;
   hasImage: boolean;
   noImage: boolean;
@@ -212,6 +220,7 @@ function derive(s: S): S {
   const hasAttendees = s.attendeeAvatars.length > 0;
   return {
     ...s,
+    hasDescriptionJson: s.descriptionJson !== "",
     noMap: !s.mapUrl,
     hasMapMarkers,
     noMapMarkers: !hasMapMarkers,
@@ -357,6 +366,14 @@ async function attendeeSummary(eventId: string): Promise<{ goingLabel: string; a
   }
 }
 
+/** The description pair: the v3 Ricos `description` for RichContent, and its plain text. A string description
+ *  (or none) keeps `eventDescription`'s legacy read, with no document. */
+function eventBody(e: WixEvent): { description: string; descriptionJson: string } {
+  const legacy = eventDescription(e);
+  const { bodyJson, bodyText } = richBody((e as unknown as { description?: unknown }).description, legacy);
+  return { description: bodyText, descriptionJson: bodyJson };
+}
+
 /** getEvent returns the slim BASE fieldset (no `registration`); enrich from the
  *  richer query when the type is unknown — best-effort, find-by-id. */
 async function enrichRegistration(id: string, e: WixEvent): Promise<WixEvent> {
@@ -364,7 +381,11 @@ async function enrichRegistration(id: string, e: WixEvent): Promise<WixEvent> {
   try {
     const list = await queryEvents({ limit: 100 });
     const match = (list.events ?? []).find((candidate) => candidate.id === id);
-    return match ?? e;
+    if (!match) return e;
+    // [rico] #3372 — the query's rows are read without TEXTS, so they carry no Ricos `description`: keep the
+    // one this detail fetched, or the enrichment would silently drop the document on every real site.
+    const description = (e as unknown as { description?: unknown }).description;
+    return description === undefined ? match : ({ ...match, description } as unknown as WixEvent);
   } catch {
     return e;
   }
@@ -377,6 +398,8 @@ const svc = defineService<S, {
   openRegistration: (s: S) => Promise<S>;
   share: (s: S) => Promise<S>;
   addToCalendar: (s: S) => Promise<S>;
+  /** [rico] #3372 — RichContent's on_link: `{ url }` of the tapped link. */
+  openLink: (s: S, arg?: unknown) => Promise<S>;
 }>("himiEventDetail", {
   state: derive({
     status: "loading",
@@ -386,6 +409,8 @@ const svc = defineService<S, {
     when: "",
     location: "",
     description: "",
+    descriptionJson: "",
+    hasDescriptionJson: false,
     image: "",
     hasImage: false,
     noImage: true,
@@ -433,7 +458,8 @@ const svc = defineService<S, {
       const id = s.id || inputId();
       if (!id) return derive({ ...s, status: "ready", errored: true });
       try {
-        const res = await getEvent(id);
+        // TEXTS adds the Ricos `description` to the base fieldset (a bare read returns none).
+        const res = await getEvent(id, { fields: ["TEXTS"] });
         let e = ((res as unknown as { event?: WixEvent }).event ?? res) as WixEvent;
         e = await enrichRegistration(id, e);
         const attendees = await attendeeSummary(id);
@@ -460,7 +486,9 @@ const svc = defineService<S, {
           initial: (title.trim()[0] || "E").toUpperCase(),
           when: eventWhen(e),
           location: eventLocation(e),
-          description: eventDescription(e),
+          // The Ricos description when the event has one (its own text is the plain copy); the legacy
+          // string fields otherwise.
+          ...eventBody(e),
           image,
           hasImage: !!image,
           noImage: !image,
@@ -491,6 +519,9 @@ const svc = defineService<S, {
             initial: (title.trim()[0] || "E").toUpperCase(),
             when: cached.dateLine,
             location: cached.location,
+            // The cached list row carries no description: an offline retry of THIS event keeps the pair it
+            // already shows, and any other event's is cleared together, so neither half can linger alone.
+            ...(s.id === id ? {} : { description: "", descriptionJson: "" }),
             image: cached.image,
             hasImage: !!cached.image,
             noImage: !cached.image,
@@ -665,6 +696,12 @@ const svc = defineService<S, {
         return derive({ ...s, actionMessage: copyParam("event.calendarAddFailed", "Could not add this event to calendar."), isAddingCalendar: false });
       }
     },
+    // Only http(s), mailto and tel links reach open_url; a refused link, or one nothing opened, says so, and a
+    // link that opens clears an earlier message.
+    openLink: async (s, arg) => derive({
+      ...s,
+      actionMessage: (await openRichLink(arg)) ? "" : copyParam("event.linkOpenFailed", "This link could not be opened."),
+    }),
   },
 });
 svc.load();

package/templates/nonprofit-cause-owner/tier5-src/_shared/rich-body.ts

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }

package/templates/nonprofit-cause-owner/tier5-src/himi-owner-lite-home/index.ts

@@ -309,7 +309,12 @@ async function measuredRevenue7d(
     if (typeof measure.total === "number") return measure.total;
     const values = measure.values ?? [];
     return values.length ? values.reduce((sum, v) => sum + (v.value || 0), 0) : undefined;
-  } catch {
+  } catch (e) {
+    // The fallback is silent on screen (Home shows the order-row sum), so say it where
+    // an agent looks: the DEV panel's Console tab and `himi logs`. The status only — a Wix
+    // failure's message carries part of the upstream body, which may hold personal data.
+    const status = (e as { status?: unknown } | null)?.status ?? /\bHTTP (\d{3})\b/.exec(String(e))?.[1];
+    console.warn("[home.revenue] analytics failed; showing the order-row sum", status !== undefined ? `HTTP ${String(status)}` : "");
     return undefined;
   }
 }

package/templates/owner-lite/tier5-src/_shared/rich-body.ts

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }

package/templates/owner-lite/tier5-src/himi-owner-lite-home/index.ts

@@ -309,7 +309,12 @@ async function measuredRevenue7d(
     if (typeof measure.total === "number") return measure.total;
     const values = measure.values ?? [];
     return values.length ? values.reduce((sum, v) => sum + (v.value || 0), 0) : undefined;
-  } catch {
+  } catch (e) {
+    // The fallback is silent on screen (Home shows the order-row sum), so say it where
+    // an agent looks: the DEV panel's Console tab and `himi logs`. The status only — a Wix
+    // failure's message carries part of the upstream body, which may hold personal data.
+    const status = (e as { status?: unknown } | null)?.status ?? /\bHTTP (\d{3})\b/.exec(String(e))?.[1];
+    console.warn("[home.revenue] analytics failed; showing the order-row sum", status !== undefined ? `HTTP ${String(status)}` : "");
     return undefined;
   }
 }

package/templates/podcast-creator/dev/index.ts

@@ -8843,7 +8843,32 @@ const SCREENS = runtimeSetting({
                               }
                             },
                             {
-                              "id": "",
+                              "id": "feed_body_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$item.bodyJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiBrandedFeed.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$item.text",
+                                        "style": "body",
+                                        "maxLines": 6
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "feed_body_text_$item.id",
                               "body": {
                                 "package": "himalaya",
                                 "type": "Text",
@@ -8852,6 +8877,9 @@ const SCREENS = runtimeSetting({
                                   "style": "body",
                                   "maxLines": 6
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.hasBodyJson"
                               }
                             },
                             {
@@ -9048,7 +9076,8 @@ const SCREENS = runtimeSetting({
       "integrity": "",
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
-        "wix_api"
+        "wix_api",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"
@@ -19110,7 +19139,33 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                               }
                             },
                             {
-                              "id": "",
+                              "id": "event_body",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "RichContent",
+                                "props": {
+                                  "documentJsonPath": "$service:himiEventDetail.descriptionJson",
+                                  "onLink": {
+                                    "actionId": "tier5.himiEventDetail.openLink"
+                                  },
+                                  "fallback": {
+                                    "id": "",
+                                    "body": {
+                                      "package": "himalaya",
+                                      "type": "Text",
+                                      "props": {
+                                        "text": "$service:himiEventDetail.description",
+                                        "style": "body",
+                                        "color": "textSecondary",
+                                        "collapseWhenEmpty": true
+                                      }
+                                    }
+                                  }
+                                }
+                              }
+                            },
+                            {
+                              "id": "event_body_text",
                               "body": {
                                 "package": "himalaya",
                                 "type": "Text",
@@ -19120,6 +19175,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                   "color": "textSecondary",
                                   "collapseWhenEmpty": true
                                 }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$service:himiEventDetail.hasDescriptionJson"
                               }
                             }
                           ]
@@ -21014,7 +21072,33 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                       }
                                     },
                                     {
-                                      "id": "",
+                                      "id": "comment_body_$item.id",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "RichContent",
+                                        "props": {
+                                          "documentJsonPath": "$item.bodyJson",
+                                          "onLink": {
+                                            "actionId": "tier5.himiBlogPost.openLink"
+                                          },
+                                          "fallback": {
+                                            "id": "",
+                                            "body": {
+                                              "package": "himalaya",
+                                              "type": "Text",
+                                              "props": {
+                                                "text": "$item.text",
+                                                "style": "body",
+                                                "color": "textSecondary",
+                                                "collapseWhenEmpty": true
+                                              }
+                                            }
+                                          }
+                                        }
+                                      }
+                                    },
+                                    {
+                                      "id": "comment_body_text_$item.id",
                                       "body": {
                                         "package": "himalaya",
                                         "type": "Text",
@@ -21024,6 +21108,9 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                                           "color": "textSecondary",
                                           "collapseWhenEmpty": true
                                         }
+                                      },
+                                      "modifiers": {
+                                        "hiddenPath": "$item.hasBodyJson"
                                       }
                                     }
                                   ]

package/templates/podcast-creator/tier5-src/_shared/rich-body.ts

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }

package/templates/podcast-creator/tier5-src/himi-blog-post/index.ts

@@ -8,7 +8,7 @@ import { isSavedId, toggleSavedId } from "../_shared/himi-blog-saved";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
 import { formatDateMedium, formatMonthDay } from "../_shared/engine-intl.js";
 import { openRichLink } from "../_shared/rich-content-link.js";
-import { richBody } from "../_shared/rich-body.js";
+import { richBody, ROW_IMAGE_WIDTH } from "../_shared/rich-body.js";
 
 // Offline-first (data-offline): the post body is a public read-through — when the
 // live fetch fails (offline) fall back to the last-synced row the feed cached under
@@ -23,8 +23,14 @@ async function readCachedPost(id: string): Promise<DbEntity | null> {
 interface CommentRow {
   id: string;
   authorName: string;
+  /** The comment's plain text: the row RichContent's fallback. */
   text: string;
   meta: string;
+  /** [rico] #3372 — the comment's Ricos document as ONE string for the row's RichContent; "" when it has none
+   *  or the encoder rejected it. */
+  bodyJson: string;
+  /** bodyJson !== "" — gates the row's plain text, because RichContent draws nothing for "". */
+  hasBodyJson: boolean;
 }
 
 interface S {
@@ -168,11 +174,15 @@ function commentMeta(row: WixBlogCommentRow): string {
 }
 
 function toCommentRow(row: WixBlogCommentRow): CommentRow {
+  // The plain text is the document's own (runs joined as written, not space-separated) when it has one.
+  const { bodyJson, bodyText } = richBody(row.richContent, row.text || "Comment", ROW_IMAGE_WIDTH);
   return {
     id: row.id,
     authorName: row.authorName || "Member",
-    text: row.text || "Comment",
+    text: bodyText,
     meta: commentMeta(row),
+    bodyJson,
+    hasBodyJson: bodyJson !== "",
   };
 }
 

package/templates/podcast-creator/tier5-src/himi-branded-lite-feed/index.ts

@@ -23,6 +23,8 @@ import { signedInEmail } from "../_shared/himi-account";
 import { initials } from "../_shared/himi-text.js";
 import { copyParam, stashCopy } from "../_shared/himi-copy.js";
 import { formatMonthDay } from "../_shared/engine-intl.js";
+import { openRichLink } from "../_shared/rich-content-link.js";
+import { richBody, ROW_IMAGE_WIDTH } from "../_shared/rich-body.js";
 
 interface FeedRow {
   id: string;
@@ -33,8 +35,15 @@ interface FeedRow {
   avatar: string;
   hasAvatar: boolean;
   noAvatar: boolean;
+  /** The post's plain text: RichContent's fallback, and what shows for a post with no Ricos document. */
   text: string;
-  /** First inline IMAGE node in the post content ("" for text-only posts). */
+  /** [rico] #3372 — a Ricos post's `content` as ONE document string for the row's RichContent; "" for a
+   *  DraftJS-blocks post, a lean one, or a document the encoder rejected. */
+  bodyJson: string;
+  /** bodyJson !== "" — gates the row's plain text, because RichContent draws nothing for "". */
+  hasBodyJson: boolean;
+  /** First inline IMAGE node in the post content ("" for text-only posts). Shown only for a row with no
+   *  document: RichContent draws the document's images itself. */
   image: string;
   hasImage: boolean;
   noImage: boolean;
@@ -161,7 +170,10 @@ function feedRow(item: WixFeedItem, profiles: WixFeedProfile[]): FeedRow {
   const author = authorName(item, profiles);
   const count = Array.isArray(item.reactionsList) ? item.reactionsList.length : 0;
   const avatar = authorAvatar(item, profiles);
-  const image = contentImage(item);
+  // A Ricos post's plain text is the whole document's (every node level), not feedText's one-level read.
+  const { bodyJson, bodyText: text } = richBody(item.content, feedText(item), ROW_IMAGE_WIDTH);
+  // A Ricos post draws its own images in RichContent, so the separate row image would repeat the first one.
+  const image = bodyJson ? "" : contentImage(item);
   return {
     id: item.feedItemId || "",
     author,
@@ -169,7 +181,9 @@ function feedRow(item: WixFeedItem, profiles: WixFeedProfile[]): FeedRow {
     avatar,
     hasAvatar: !!avatar,
     noAvatar: !avatar,
-    text: feedText(item),
+    text,
+    bodyJson,
+    hasBodyJson: bodyJson !== "",
     image,
     hasImage: !!image,
     noImage: !image,
@@ -292,6 +306,8 @@ const svc = defineService<State, {
   filter: (state: State, arg?: unknown) => State;
   post: (state: State, arg?: unknown) => Promise<State>;
   react: (state: State, arg?: unknown) => Promise<State>;
+  /** [rico] #3372 — a row RichContent's on_link: `{ url }` of the tapped link. */
+  openLink: (state: State, arg?: unknown) => Promise<State>;
 }>("himiBrandedFeed", {
   state: derive({
     status: "loading",
@@ -367,6 +383,10 @@ const svc = defineService<State, {
         return state;
       }
     },
+    // Only http(s), mailto and tel links reach open_url; one that does not open says so in the message line.
+    openLink: async (state, arg) => ((await openRichLink(arg))
+      ? state
+      : { ...state, message: copyParam("feed.linkOpenFailed", "This link could not be opened.") }),
   },
 });
 

package/templates/podcast-creator/tier5-src/himi-branded-lite-home/index.ts

@@ -508,7 +508,12 @@ async function fetchBookingsSignal(arg: unknown): Promise<BookingsSignal> {
   try {
     const response = await queryServices({ query: { paging: { limit: 50 } } });
     return bookingsSignal(response.services ?? []);
-  } catch {
+  } catch (e) {
+    // The block collapses without a word on screen, so say why where an agent looks:
+    // the DEV panel's Console tab and `himi logs`. The status only — a Wix failure's
+    // message carries part of the upstream body, which may hold personal data.
+    const status = (e as { status?: unknown } | null)?.status ?? /\bHTTP (\d{3})\b/.exec(String(e))?.[1];
+    console.warn("[home.bookings] services query failed; showcase hidden", status !== undefined ? `HTTP ${String(status)}` : "");
     return emptyBookingsSignal();
   }
 }

package/templates/podcast-creator/tier5-src/himi-events-detail/index.ts

@@ -35,6 +35,8 @@ import {
 } from "../_shared/himi-events";
 import { initials } from "../_shared/himi-text.js";
 import { stashCopy, copyParam, copyTemplate } from "../_shared/himi-copy.js";
+import { openRichLink } from "../_shared/rich-content-link.js";
+import { richBody } from "../_shared/rich-body.js";
 
 interface MapMarker {
   latitude: number;
@@ -88,7 +90,13 @@ interface S {
   initial: string;
   when: string;
   location: string;
+  /** The plain-text description: RichContent's fallback, the calendar notes, and what shows with no document. */
   description: string;
+  /** [rico] #3372 — the v3 Ricos `description` (read with `fields=TEXTS`) as ONE document string for
+   *  RichContent; "" when the event has none or the encoder rejected it. */
+  descriptionJson: string;
+  /** descriptionJson !== "" — gates the plain text, because RichContent draws nothing for "". */
+  hasDescriptionJson: boolean;
   image: string;
   hasImage: boolean;
   noImage: boolean;
@@ -212,6 +220,7 @@ function derive(s: S): S {
   const hasAttendees = s.attendeeAvatars.length > 0;
   return {
     ...s,
+    hasDescriptionJson: s.descriptionJson !== "",
     noMap: !s.mapUrl,
     hasMapMarkers,
     noMapMarkers: !hasMapMarkers,
@@ -357,6 +366,14 @@ async function attendeeSummary(eventId: string): Promise<{ goingLabel: string; a
   }
 }
 
+/** The description pair: the v3 Ricos `description` for RichContent, and its plain text. A string description
+ *  (or none) keeps `eventDescription`'s legacy read, with no document. */
+function eventBody(e: WixEvent): { description: string; descriptionJson: string } {
+  const legacy = eventDescription(e);
+  const { bodyJson, bodyText } = richBody((e as unknown as { description?: unknown }).description, legacy);
+  return { description: bodyText, descriptionJson: bodyJson };
+}
+
 /** getEvent returns the slim BASE fieldset (no `registration`); enrich from the
  *  richer query when the type is unknown — best-effort, find-by-id. */
 async function enrichRegistration(id: string, e: WixEvent): Promise<WixEvent> {
@@ -364,7 +381,11 @@ async function enrichRegistration(id: string, e: WixEvent): Promise<WixEvent> {
   try {
     const list = await queryEvents({ limit: 100 });
     const match = (list.events ?? []).find((candidate) => candidate.id === id);
-    return match ?? e;
+    if (!match) return e;
+    // [rico] #3372 — the query's rows are read without TEXTS, so they carry no Ricos `description`: keep the
+    // one this detail fetched, or the enrichment would silently drop the document on every real site.
+    const description = (e as unknown as { description?: unknown }).description;
+    return description === undefined ? match : ({ ...match, description } as unknown as WixEvent);
   } catch {
     return e;
   }
@@ -377,6 +398,8 @@ const svc = defineService<S, {
   openRegistration: (s: S) => Promise<S>;
   share: (s: S) => Promise<S>;
   addToCalendar: (s: S) => Promise<S>;
+  /** [rico] #3372 — RichContent's on_link: `{ url }` of the tapped link. */
+  openLink: (s: S, arg?: unknown) => Promise<S>;
 }>("himiEventDetail", {
   state: derive({
     status: "loading",
@@ -386,6 +409,8 @@ const svc = defineService<S, {
     when: "",
     location: "",
     description: "",
+    descriptionJson: "",
+    hasDescriptionJson: false,
     image: "",
     hasImage: false,
     noImage: true,
@@ -433,7 +458,8 @@ const svc = defineService<S, {
       const id = s.id || inputId();
       if (!id) return derive({ ...s, status: "ready", errored: true });
       try {
-        const res = await getEvent(id);
+        // TEXTS adds the Ricos `description` to the base fieldset (a bare read returns none).
+        const res = await getEvent(id, { fields: ["TEXTS"] });
         let e = ((res as unknown as { event?: WixEvent }).event ?? res) as WixEvent;
         e = await enrichRegistration(id, e);
         const attendees = await attendeeSummary(id);
@@ -460,7 +486,9 @@ const svc = defineService<S, {
           initial: (title.trim()[0] || "E").toUpperCase(),
           when: eventWhen(e),
           location: eventLocation(e),
-          description: eventDescription(e),
+          // The Ricos description when the event has one (its own text is the plain copy); the legacy
+          // string fields otherwise.
+          ...eventBody(e),
           image,
           hasImage: !!image,
           noImage: !image,
@@ -491,6 +519,9 @@ const svc = defineService<S, {
             initial: (title.trim()[0] || "E").toUpperCase(),
             when: cached.dateLine,
             location: cached.location,
+            // The cached list row carries no description: an offline retry of THIS event keeps the pair it
+            // already shows, and any other event's is cleared together, so neither half can linger alone.
+            ...(s.id === id ? {} : { description: "", descriptionJson: "" }),
             image: cached.image,
             hasImage: !!cached.image,
             noImage: !cached.image,
@@ -665,6 +696,12 @@ const svc = defineService<S, {
         return derive({ ...s, actionMessage: copyParam("event.calendarAddFailed", "Could not add this event to calendar."), isAddingCalendar: false });
       }
     },
+    // Only http(s), mailto and tel links reach open_url; a refused link, or one nothing opened, says so, and a
+    // link that opens clears an earlier message.
+    openLink: async (s, arg) => derive({
+      ...s,
+      actionMessage: (await openRichLink(arg)) ? "" : copyParam("event.linkOpenFailed", "This link could not be opened."),
+    }),
   },
 });
 svc.load();

package/templates/podcast-creator-owner/tier5-src/_shared/rich-body.ts

@@ -14,15 +14,21 @@ export interface RichBody {
   bodyText: string;
 }
 
+/** [rico] #3372 — the media width for a document drawn in a LIST row (a feed post, a comment, a CMS item): the
+ *  list-image size (WIX_LIST_IMAGE), so a scrolling list never downloads every image at detail size. */
+export const ROW_IMAGE_WIDTH = 1000;
+
 /** Prepares `richContent` (a Ricos document, as a Wix API returns it, or its JSON string). No document, or one
  *  that is not a document, gives `{ bodyJson: "", bodyText: fallback }`. A document past the viewer's limits
  *  gives bodyJson "" and its plain text — except one rejected as too deep, which is not walked again (the
- *  plain-text walk has no depth limit), so `fallback` stands in for it. */
-export function richBody(richContent: unknown, fallback = ""): RichBody {
+ *  plain-text walk has no depth limit), so `fallback` stands in for it. `imageWidth` sizes its media (default
+ *  the 1400 px detail budget). */
+export function richBody(richContent: unknown, fallback = "", imageWidth = 1400): RichBody {
   const doc = parseRicosJson(richContent);
   if (!doc) return { bodyJson: "", bodyText: fallback };
-  // 1400 px — the detail-image budget, which is also the encoder's maximum.
-  const { json, rejected } = encodeRichContent(doc, { imageWidth: 1400 });
+  // 1400 px by default — the detail-image budget, which is also the encoder's maximum; list rows pass
+  // ROW_IMAGE_WIDTH.
+  const { json, rejected } = encodeRichContent(doc, { imageWidth });
   const text = rejected === "too_deep" ? "" : ricosToPlainText(doc);
   return { bodyJson: json, bodyText: text || fallback };
 }