@wix/himalaya-cli 0.1151.0 → 0.1153.0

package/guides/push-cli-onboarding.md

@@ -83,7 +83,48 @@ After setup, continue normal app development, validation, publish/preview/promot
 native distribution. Native push configuration, member authentication, device-token
 registration and a delivery/tap test are still required; for the test, see
 [Send a test notification](#send-a-test-notification). Setup does not enable native
-capabilities, choose a Ping family, send notifications or verify phone delivery.
+capabilities, choose a Ping family, send notifications or verify phone delivery; the app's
+`config.ts` does the first two (see [Native push configuration](#native-push-configuration)).
+
+## Native push configuration
+
+The app's own `config.ts` turns push on; `himi notify setup` never edits it.
+
+```ts
+auth: WixConsumerAuthProvider({
+  siteId: "<metaSiteId>",              // the site himi notify setup configured
+  clientId: "<headless-client-id>",
+  siteUrl: "https://<your-site>",
+  redirectUri: "<scheme>://oauth/callback",
+  bootAsVisitor: true,
+}),
+capabilities: ["push" /* , … */],
+push: {
+  registrar: "wix-ping",
+  pingAppName: "WixBrandedWebApp",
+  requestPermissionOnLaunch: true,
+  payloadAdapter: "wix-ping",
+  routes: [
+    { match: "my-account/:site/stores/orders/:orderId",
+      link: "<scheme>://screen/<order-screen>?id={orderId}" },
+  ],
+},
+```
+
+- `pingAppName` is the Ping app family the device registers under. Use `WixBrandedWebApp`:
+  Ping allows it for site members and uses the credentials `himi notify setup` stored for
+  the site. A build signed for the APNs development environment appends `.sandbox` itself;
+  do not add it.
+- The device registers only after a member signs in; a visitor's device receives nothing.
+  Keep `siteId` in `auth` on the site `himi notify setup` configured. A changed `siteId` or
+  `clientId` ships with `himi push` like the rest of the config, and the app picks it up on
+  its next launch; until then iOS stops registering rather than register the old site.
+- `routes` turn the Wix links inside notifications into the app's screens, one route per
+  link shape. A notification whose link matches no route opens the app without navigating.
+  `himi validate` warns when a route names a screen the app does not declare.
+- The `push` block ships with `himi push`; changing it needs no new binary. The binary still
+  has to carry the push entitlement: the `branded-lite` shell requests it, and the signing
+  profile must grant `aps-environment` (see the QA build notes below).
 
 **Customer push QA builds use `himi dist --signing byo`.** After publishing an approved
 release, use a backend and reachable runner source that support the customer-signing flow.

package/guides/sdk-reference.json

@@ -7337,7 +7337,7 @@
         "kind": "function",
         "jsdoc": "",
         "decl": "export function deleteService(\n  serviceId: string,\n  opts?: WixCallOptions,\n): Promise<WixDeleteServiceResponse>;",
-        "http": "DELETE /bookings/v1/services/{…}"
+        "http": "DELETE /bookings/v2/services/{…}"
       },
       {
         "name": "WixServiceMoney",
@@ -7355,7 +7355,7 @@
         "name": "WixService",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixService {\n  id: string;\n  name?: string;\n  description?: string;\n  /** Session length in minutes. */\n  duration?: number;\n  /** Raw Bookings v2 response shape. */\n  payment?: WixServicePayment;\n  schedule?: { availabilityConstraints?: { sessionDurations?: number[] } };\n  /** @deprecated Compatibility projection populated by `decodeService`. */\n  price?: number;\n  /** @deprecated Legacy v1 compatibility field. */\n  category?: string;\n}"
+        "decl": "export interface WixService {\n  id: string;\n  /** Optimistic-concurrency token — required by every v2 write (updateService reads it if omitted). */\n  revision?: string;\n  name?: string;\n  description?: string;\n  /** Session length in minutes. */\n  duration?: number;\n  /** Raw Bookings v2 response shape. */\n  payment?: WixServicePayment;\n  schedule?: { availabilityConstraints?: { sessionDurations?: number[] } };\n  /** @deprecated Compatibility projection populated by `decodeService`. */\n  price?: number;\n  /** @deprecated Legacy v1 compatibility field. */\n  category?: string;\n}"
       },
       {
         "name": "decodeService",
@@ -7441,8 +7441,8 @@
       {
         "name": "WixServiceWrite",
         "kind": "interface",
-        "jsdoc": "/** Writable service fields for create/update. `name` + `duration` are required on create. */",
-        "decl": "export interface WixServiceWrite {\n  name?: string;\n  description?: string;\n  /** Session length in minutes; required, > 0 on create. */\n  duration?: number;\n  price?: number;\n  category?: string;\n}"
+        "jsdoc": "/** Writable service fields for create/update, in the ERGONOMIC shape a form has. The helpers\n *  below encode it onto the Bookings v2 entity — they never send these flat fields as-is,\n *  because v2 silently ignores a flat `price`/`duration` (HTTP 200, revision bumps, nothing\n *  written: #3605, verified live 2026-10-01).\n *  - `price` → `payment.fixed.price.{value,currency}` (value is a decimal STRING), merged\n *    with the service's existing `payment` so `payment.options` (mandatory: online and/or\n *    in-person) and the currency carry over.\n *  - `duration` (minutes) → `schedule.availabilityConstraints.{durations,sessionDurations}`. */",
+        "decl": "export interface WixServiceWrite {\n  name?: string;\n  description?: string;\n  /** Session length in minutes; required, > 0 on create. */\n  duration?: number;\n  /** Fixed price as a number (e.g. 120). Encoded onto `payment.fixed.price`. */\n  price?: number;\n  /** ISO currency for `price`. Defaults to the service's current currency on update; required on create with a price. */\n  currency?: string;\n  /** Resource ids of the staff who deliver it (`queryStaff()` → `id`). An APPOINTMENT service needs ≥1;\n   *  createService defaults to the site's `defaultStaff` resource when omitted. NOT staff-member ids. */\n  staffMemberIds?: string[];\n  /** v2 service type; createService defaults to \"APPOINTMENT\". */\n  type?: \"APPOINTMENT\" | \"CLASS\" | \"COURSE\";\n  onlineBooking?: { enabled?: boolean };\n  /** Raw v2 payment object — wins over `price`/`currency` when both are given. */\n  payment?: Record<string, unknown>;\n  /** @deprecated v1 only — v2 services carry `category.id`; ignored by create/update. */\n  category?: string;\n}"
       },
       {
         "name": "WixCreateServiceRequest",
@@ -7474,18 +7474,24 @@
         "jsdoc": "",
         "decl": "export interface WixDeleteServiceResponse {\n  // Empty object on success.\n}"
       },
+      {
+        "name": "encodeServiceWrite",
+        "kind": "function",
+        "jsdoc": "/** Encode an ergonomic write onto the v2 service entity. `existing` (the current service, for\n *  an update) supplies the currency and `payment.options` a price change must carry. Exported\n *  for tests; throws instead of sending a payload Bookings would accept and then ignore. */",
+        "decl": "export function encodeServiceWrite(write: WixServiceWrite, existing?: WixService): Record<string, unknown>;"
+      },
       {
         "name": "createService",
         "kind": "function",
-        "jsdoc": "/** Create a service — POST /bookings/v1/services. `name`, `duration` are required. */",
-        "decl": "export function createService(service: WixServiceWrite): Promise<WixCreateServiceResponse>;",
-        "http": "POST /bookings/v1/services"
+        "jsdoc": "/** Create a service — POST /bookings/v2/services (the v1 route 400s for a v2 site: #3605).\n *  `name` + `duration` are required. Defaults: type APPOINTMENT, online booking on, and the\n *  site's `defaultStaff` resource when `staffMemberIds` is omitted (an APPOINTMENT service\n *  400s MISSING_APPOINTMENT_RESOURCES without one), and — for a `price` without `currency` —\n *  the currency the site's existing services use. */",
+        "decl": "export async function createService(service: WixServiceWrite): Promise<WixCreateServiceResponse>;",
+        "http": "POST /bookings/v2/services"
       },
       {
         "name": "updateService",
         "kind": "function",
         "jsdoc": "",
-        "decl": "export function updateService(serviceId: string, service: WixServiceWrite & { revision?: string }): Promise<WixUpdateServiceResponse>;",
+        "decl": "export async function updateService(serviceId: string, service: WixServiceWrite & { revision?: string }): Promise<WixUpdateServiceResponse>;",
         "http": "PATCH /bookings/v2/services/{…}"
       },
       {
@@ -11347,11 +11353,17 @@
         "jsdoc": "",
         "decl": "export interface WixDataPaging {\n  limit?: number;\n  offset?: number;\n}"
       },
+      {
+        "name": "WixDataSort",
+        "kind": "interface",
+        "jsdoc": "/** One sort key — `{ fieldName: \"postedDate\", order: \"DESC\" }`. Keys apply in array order. */",
+        "decl": "export interface WixDataSort {\n  fieldName: string;\n  order?: \"ASC\" | \"DESC\";\n}"
+      },
       {
         "name": "WixQueryDataItemsRequest",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface WixQueryDataItemsRequest {\n  dataCollectionId: string;\n  query?: {\n    filter?: Record<string, unknown>;\n    paging?: WixDataPaging;\n    sort?: unknown[];\n  };\n  /** When true, `pagingMetadata.total` is filled (offset paging only). Default omitted. */\n  returnTotalCount?: boolean;\n}"
+        "decl": "export interface WixQueryDataItemsRequest {\n  dataCollectionId: string;\n  query?: {\n    filter?: Record<string, unknown>;\n    paging?: WixDataPaging;\n    sort?: WixDataSort[];\n  };\n  /** When true, `pagingMetadata.total` is filled (offset paging only). Default omitted. */\n  returnTotalCount?: boolean;\n}"
       },
       {
         "name": "WixQueryDataItemsResponse",
@@ -11374,8 +11386,8 @@
       {
         "name": "queryDataItems",
         "kind": "function",
-        "jsdoc": "/** Query items in a collection — POST /wix-data/v2/items/query.\n *\n *  `filter` is the Wix Data v2 filter object, which the type cannot express (it is\n *  `Record<string, unknown>` by construction). A field name maps to a value for\n *  equality, or to an operator object:\n *\n *  ```ts\n *  await queryDataItems(\"Listings\", 20, { city: \"Tel Aviv\" });\n *  await queryDataItems(\"Listings\", 20, { price: { $lte: 2_500_000 } });\n *  await queryDataItems(\"Listings\", 20, { _id: { $in: [a, b] } });\n *  ```\n *\n *  `offset` pages: ask for `limit` rows starting at `offset`. Pair it with\n *  `returnTotalCount: true`, which fills `pagingMetadata.total` so a caller knows\n *  when to stop — it is omitted by default because counting is extra work, and it\n *  reports total for OFFSET paging only, which is the mode this function uses.\n *\n *  ```ts\n *  const first = await queryDataItems(\"Listings\", 50, undefined, true);\n *  const total = first.pagingMetadata?.total ?? 0;\n *  const rest  = await queryDataItems(\"Listings\", 50, undefined, false, 50);\n *  ```\n *\n *  To read ONE row, use `getDataItem` rather than a page plus a client-side\n *  `.find()` — that pattern breaks silently once the collection outgrows `limit`. */",
-        "decl": "export function queryDataItems(\n  dataCollectionId: string,\n  limit = 50,\n  filter?: Record<string, unknown>,\n  returnTotalCount = false,\n  offset = 0,\n): Promise<WixQueryDataItemsResponse>;",
+        "jsdoc": "/** Query items in a collection — POST /wix-data/v2/items/query.\n *\n *  `filter` is the Wix Data v2 filter object, which the type cannot express (it is\n *  `Record<string, unknown>` by construction). A field name maps to a value for\n *  equality, or to an operator object:\n *\n *  ```ts\n *  await queryDataItems(\"Listings\", 20, { city: \"Tel Aviv\" });\n *  await queryDataItems(\"Listings\", 20, { price: { $lte: 2_500_000 } });\n *  await queryDataItems(\"Listings\", 20, { _id: { $in: [a, b] } });\n *  ```\n *\n *  `offset` pages: ask for `limit` rows starting at `offset`. Pair it with\n *  `returnTotalCount: true`, which fills `pagingMetadata.total` so a caller knows\n *  when to stop — it is omitted by default because counting is extra work, and it\n *  reports total for OFFSET paging only, which is the mode this function uses.\n *\n *  ```ts\n *  const first = await queryDataItems(\"Listings\", 50, undefined, true);\n *  const total = first.pagingMetadata?.total ?? 0;\n *  const rest  = await queryDataItems(\"Listings\", 50, undefined, false, 50);\n *  ```\n *\n *  `sort` orders server-side, so \"newest first\" is one call instead of fetching every row\n *  and sorting on the client (which also breaks once the collection outgrows `limit`):\n *\n *  ```ts\n *  await queryDataItems(\"Jobs\", 1, undefined, false, 0, [{ fieldName: \"postedDate\", order: \"DESC\" }]);\n *  ```\n *\n *  To read ONE row, use `getDataItem` rather than a page plus a client-side\n *  `.find()` — that pattern breaks silently once the collection outgrows `limit`. */",
+        "decl": "export function queryDataItems(\n  dataCollectionId: string,\n  limit = 50,\n  filter?: Record<string, unknown>,\n  returnTotalCount = false,\n  offset = 0,\n  sort?: WixDataSort[],\n): Promise<WixQueryDataItemsResponse>;",
         "http": "POST /wix-data/v2/items/query"
       },
       {

package/guides/templates.md

@@ -115,6 +115,7 @@ himi template inspect                        # recompute the inventory after edi
 himi template screens                        # list dev/index.ts screens without reading the file
 himi template screens --show himi_saved > saved.txt    # ONE screen's entry
 himi template screens --write himi_saved --from saved.txt   # put it back — re-parsed, refused if it breaks the file
+himi template screens --add himi_sellers --from sellers.txt --parent himi_branded_home   # a NEW screen, registered as linkable
 himi template sweep --set "Sample content=>Our latest" --dry-run   # copy inside string literals only
 himi template trim --from-spec --links drop --dry-run   # keep SPEC.md's Screen catalogue ids — read fromSpec.droppedPrimary first
 ```

package/guides/wix-api-usage.md

@@ -180,9 +180,13 @@ surface. Lead with it: it builds the request, calls the bridge, and decodes the
 ```ts
 import { queryDataItems, insertDataItem, updateDataItem, removeDataItem } from "@himalaya/wix-data";
 
-// queryDataItems(collectionId, limit = 50, filter?) → { dataItems?, items?, pagingMetadata? }
+// queryDataItems(collectionId, limit = 50, filter?, returnTotalCount = false, offset = 0, sort?)
+//   → { dataItems?, items?, pagingMetadata? }
 const res = await queryDataItems("MyCollection", 50);
 const rows = (res.dataItems ?? res.items ?? []).map((it) => it.data);   // parsed objects, not bytes
+
+// Order server-side — "newest first" is one call, not every row fetched and sorted on the client:
+const newest = await queryDataItems("Jobs", 1, undefined, false, 0, [{ fieldName: "postedDate", order: "DESC" }]);
 ```
 
 The full items CRUD is typed: `insertDataItem(collectionId, data)` (POST `/wix-data/v2/items`),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1151.0",
+  "version": "0.1153.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -67,5 +67,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "6b5cae29c39be16202e9a70f806ba56b0921bfe01cec8021fe36a964"
+  "falconPackageHash": "18d6e0952993df1eccb6d9a826c4ec2fa5cf335d69a8cdf02e4891f2"
 }

package/templates/beauty-salon/dev/index.ts

@@ -2336,7 +2336,7 @@ const SCREENS = runtimeSetting({
             "verticals": "[\"store\",\"bookings\",\"plans\",\"blog\"]",
             "homeModules": "[{\"id\":\"member_progress\",\"label\":\"This week's schedule\",\"dataSource\":\"member.bookings.schedule\",\"emptyWhen\":[\"hideMemberProgress\"]},{\"id\":\"up_next\",\"label\":\"Up next\",\"dataSource\":\"member.bookings\",\"emptyWhen\":[\"hideNextBooking\",\"hidePersonalError\"]},{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"salonLuxe.section0\",\"emptyWhen\":[\"hideHeroImage\"]},{\"id\":\"section_1\",\"label\":\"__HIMI_APP_NAME__\",\"dataSource\":\"salonLuxe.section1\"}]",
             "ownerDefaultLayout": "salonLuxe",
-            "copy": "{\"home.bookVisitCta\":\"Book a visit\",\"home.featuredTitle\":\"Salon picks\",\"home.stylistsCaption\":\"Meet your stylists\",\"home.treatmentsSubtitle\":\"Book your favorite in a couple of taps.\",\"home.treatmentsTitle\":\"Signature treatments\"}"
+            "copy": "{\"home.bookVisitCta\":\"Book a visit\",\"home.featuredTitle\":\"Salon picks\",\"home.profileBody\":\"Sign in for orders, bookings, memberships and saved posts.\",\"home.stylistsCaption\":\"Meet your stylists\",\"home.treatmentsSubtitle\":\"Book your favorite in a couple of taps.\",\"home.treatmentsTitle\":\"Signature treatments\"}"
           }
         }
       }
@@ -2387,7 +2387,7 @@ const SCREENS = runtimeSetting({
                 "package": "himalaya",
                 "type": "Text",
                 "props": {
-                  "text": "Orders, bookings, RSVPs and saved content in one place.",
+                  "text": "Orders, bookings, memberships and saved content in one place.",
                   "style": "body",
                   "color": "textSecondary"
                 }
@@ -3876,7 +3876,10 @@ const SCREENS = runtimeSetting({
           "bottom": 28
         },
         "onAppear": {
-          "actionId": "tier5.himiStoreAccount.refresh"
+          "actionId": "tier5.himiStoreAccount.refresh",
+          "params": {
+            "copy": "{\"account.subtitle\":\"Orders, bookings, memberships and saved content in one place.\",\"storeAccount.authBody\":\"Sign in to continue — cart, bookings and memberships stay with you.\",\"storeAccount.authBodyRegister\":\"Create a member account to continue — cart, bookings and memberships stay with you.\"}"
+          }
         }
       }
     },

package/templates/community-club/dev/index.ts

@@ -1958,7 +1958,7 @@ const SCREENS = runtimeSetting({
             "verticals": "[\"feed\",\"events\",\"blog\",\"groups\",\"cms\"]",
             "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Discover 1\",\"dataSource\":\"communityPulse.section0\",\"emptyWhen\":[\"noMemberAvatars\"]},{\"id\":\"section_1\",\"label\":\"Announcement\",\"dataSource\":\"communityPulse.section1\",\"emptyWhen\":[\"noAnnouncement\",\"noUpcomingEvents\"]},{\"id\":\"section_2\",\"label\":\"Groups\",\"dataSource\":\"communityPulse.section2\",\"emptyWhen\":[\"noGroupCards\"]},{\"id\":\"section_3\",\"label\":\"Latest activity\",\"dataSource\":\"communityPulse.section3\"}]",
             "ownerDefaultLayout": "communityPulse",
-            "copy": "{\"home.activityTitle\":\"Latest activity\",\"home.announcementCaption\":\"Announcement\",\"home.eventsTitle\":\"Upcoming events\",\"home.groupsSubtitle\":\"Find your people.\",\"home.groupsTitle\":\"Groups\",\"home.membersCaption\":\"Our members\",\"home.onboardingBody\":\"Join groups, RSVP to events, and keep up with the community feed — all in one place.\"}"
+            "copy": "{\"home.activityTitle\":\"Latest activity\",\"home.announcementCaption\":\"Announcement\",\"home.eventsTitle\":\"Upcoming events\",\"home.groupsSubtitle\":\"Find your people.\",\"home.groupsTitle\":\"Groups\",\"home.membersCaption\":\"Our members\",\"home.onboardingBody\":\"Join groups, RSVP to events, and keep up with the community feed — all in one place.\",\"home.profileBody\":\"Sign in for RSVPs, groups and saved posts.\"}"
           }
         }
       }
@@ -2009,7 +2009,7 @@ const SCREENS = runtimeSetting({
                 "package": "himalaya",
                 "type": "Text",
                 "props": {
-                  "text": "Orders, bookings, RSVPs and saved content in one place.",
+                  "text": "RSVPs, groups and saved content in one place.",
                   "style": "body",
                   "color": "textSecondary"
                 }
@@ -3145,7 +3145,10 @@ const SCREENS = runtimeSetting({
           "bottom": 28
         },
         "onAppear": {
-          "actionId": "tier5.himiStoreAccount.refresh"
+          "actionId": "tier5.himiStoreAccount.refresh",
+          "params": {
+            "copy": "{\"account.subtitle\":\"RSVPs, groups and saved content in one place.\",\"storeAccount.authBody\":\"Sign in to continue — RSVPs and groups stay with you.\",\"storeAccount.authBodyRegister\":\"Create a member account to continue — RSVPs and groups stay with you.\"}"
+          }
         }
       }
     },

package/templates/community-club-owner/dev/index.ts

@@ -76662,6 +76662,48 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                         }
                       }
                     },
+                    {
+                      "id": "event_body",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "RichContent",
+                        "props": {
+                          "documentJsonPath": "$service:himiOwnerLiteEvent.bodyJson",
+                          "onLink": {
+                            "actionId": "tier5.himiOwnerLiteEvent.openLink"
+                          },
+                          "fallback": {
+                            "id": "",
+                            "body": {
+                              "package": "himalaya",
+                              "type": "Text",
+                              "props": {
+                                "text": "$service:himiOwnerLiteEvent.bodyText",
+                                "style": "body",
+                                "color": "textPrimary",
+                                "collapseWhenEmpty": true
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      "id": "event_body_text",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "$service:himiOwnerLiteEvent.bodyText",
+                          "style": "body",
+                          "color": "textPrimary",
+                          "collapseWhenEmpty": true
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteEvent.hasBodyJson"
+                      }
+                    },
                     {
                       "id": "event_info_card",
                       "body": {
@@ -77000,7 +77042,8 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
         "wix_api",
-        "local_database"
+        "local_database",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"

package/templates/community-club-owner/tier5-src/himi-owner-lite-event/index.ts

@@ -11,7 +11,9 @@ import { normalizeEvent, eventDescription } from "../_shared/himi-events.js";
 import { ownerLoadError, isBridgeUnavailable, isOwnerPreviewDemo, shouldQueueOwnerWrite } from "../_shared/owner-load-error.js";
 import { DEMO_EVENTS, DEMO_NOTE, DEMO_SAVE_NOTE } from "../_shared/owner-preview-demo.js";
 import { stashCopy, copyParam } from "../_shared/himi-copy.js";
-import { get as dbGet, remove as dbRemove, enqueue as dbEnqueue, type DbEntity } from "../_shared/owner-local-db.js";
+import { openRichLink } from "../_shared/rich-content-link.js";
+import { richBody } from "../_shared/rich-body.js";
+import { get as dbGet, upsert as dbUpsert, remove as dbRemove, enqueue as dbEnqueue, type DbEntity } from "../_shared/owner-local-db.js";
 
 // Offline-first (data-offline): the event DETAIL falls back to the last-synced
 // local `owner_events` row (put by the event form's write-behind) on a failed
@@ -20,6 +22,7 @@ import { get as dbGet, remove as dbRemove, enqueue as dbEnqueue, type DbEntity }
 // ENQUEUED for replay on reconnect. Every local-db call is wrapped so a build
 // without the `local_database` grant behaves exactly as before (online-only).
 const ENTITY = "owner_events";
+async function cachePut(row: DbEntity): Promise<void> { try { await dbUpsert(ENTITY, row); } catch { /* capability not granted */ } }
 async function cacheDrop(id: string): Promise<void> { try { await dbRemove(ENTITY, id); } catch { /* capability not granted */ } }
 async function cacheGet(id: string): Promise<DbEntity | null> { try { return await dbGet(ENTITY, id); } catch { return null; } }
 async function queueWrite(actionId: string, params: Record<string, string>): Promise<void> { try { await dbEnqueue(actionId, params); } catch { /* capability not granted */ } }
@@ -33,6 +36,13 @@ interface EventState {
   title: string;
   subtitle: string;
   summary: string;
+  // Body ([rico] #3499) — RichContent binds bodyJson; the plain text shows when there is no document.
+  /** The v3 Ricos `description` (read with `fields=TEXTS`) as ONE document string; "" when there is none. */
+  bodyJson: string;
+  /** bodyJson !== "" — gates the plain text, because RichContent draws nothing for "". */
+  hasBodyJson: boolean;
+  /** The description's plain text (the document's own text, else the legacy description). */
+  bodyText: string;
   initial: string;
   image: string;
   dateLine: string;
@@ -55,6 +65,17 @@ interface EventState {
 }
 
 /* eslint-disable @typescript-eslint/no-explicit-any */
+/** [rico] #3499 — keep the description's plain text with the event's cached row, so the offline detail shows it.
+ *  Merged into the row the events list (or the form) wrote rather than replacing it; with no row yet, the
+ *  loaded detail's own fields become one. */
+async function cacheBodyText(s: EventState): Promise<void> {
+  if (s.status !== "ready" || !s.id) return;
+  const prev = await cacheGet(s.id);
+  await cachePut(prev ? { ...prev, bodyText: s.bodyText } : {
+    id: s.id, title: s.title, subtitle: s.subtitle, image: s.image, dateLine: s.dateLine, location: s.location,
+    statusLabel: s.statusLabel, registration: s.registration, bodyText: s.bodyText,
+  });
+}
 function idFrom(arg: unknown, fallback = ""): string {
   return typeof arg === "string" ? arg : String((arg as any)?.id ?? fallback);
 }
@@ -97,6 +118,9 @@ function shape(s: Partial<EventState>): EventState {
     title: s.title ?? "",
     subtitle: s.subtitle ?? "",
     summary: s.summary ?? "",
+    bodyJson: s.bodyJson ?? "",
+    hasBodyJson: !!s.bodyJson,
+    bodyText: s.bodyText ?? "",
     initial: s.initial ?? "?",
     image,
     dateLine: s.dateLine ?? "—",
@@ -128,7 +152,9 @@ function demoDetail(s: EventState, id: string): EventState | null {
     status: "ready",
     title: d.title,
     subtitle: [d.dateLine, d.location].filter(Boolean).join(" · "),
-    summary: d.description,
+    summary: "",
+    bodyJson: "",
+    bodyText: d.description,
     initial: (d.title[0] || "?").toUpperCase(),
     image: "",
     dateLine: d.dateLine,
@@ -151,7 +177,9 @@ function cachedDetail(s: EventState, row: DbEntity): EventState {
     status: "ready",
     title,
     subtitle: String(row.subtitle ?? [dateLine, location].filter((x) => x && x !== "—").join(" · ")),
-    summary: String(row.summary ?? row.description ?? ""),
+    summary: "",
+    bodyJson: "",
+    bodyText: String(row.bodyText ?? row.summary ?? row.description ?? ""),
     initial: String(row.initial ?? (title[0] || "?")).slice(0, 1).toUpperCase(),
     image: String(row.image ?? ""),
     dateLine: dateLine || "—",
@@ -164,21 +192,27 @@ function cachedDetail(s: EventState, row: DbEntity): EventState {
 }
 
 async function refresh(prev: EventState, id: string): Promise<EventState> {
-  const res = await getEvent(id);
+  // A bare read returns the base fieldset: DETAILS adds `shortDescription` (the teaser and the legacy body),
+  // TEXTS the Ricos `description`.
+  const res = await getEvent(id, { fields: ["DETAILS", "TEXTS"] });
   const ev = (res.event ?? res) as WixEvent;
   if (!ev || !(ev as any).id) {
     return shape({ ...prev, id, status: "error", title: "", error: copyParam("ownerEvent.errorNotFound", "event not found") });
   }
   const row = normalizeEvent(ev); // reuses date/location/status normalization
   const image = /^https?:\/\//.test(row.image) ? row.image : "";
-  const desc = (eventDescription(ev) || "").trim();
+  const { bodyJson, bodyText } = richBody((ev as unknown as { description?: unknown }).description, (eventDescription(ev) || "").trim());
+  // The teaser stays above the body only when it says something the body does not.
+  const teaser = String((ev as any).shortDescription ?? "").trim();
   return shape({
     ...prev,
     id,
     status: "ready",
     title: row.title,
     subtitle: [row.dateLine, row.location].filter((x) => x && x !== "—").join(" · "),
-    summary: desc,
+    summary: teaser && teaser !== bodyText.trim() ? teaser : "",
+    bodyJson,
+    bodyText,
     initial: (row.title[0] || "?").toUpperCase(),
     image,
     dateLine: row.dateLine || "—",
@@ -194,6 +228,7 @@ const svc = defineService<EventState, {
   load: (s: EventState, arg?: unknown) => Promise<EventState>;
   retry: (s: EventState) => Promise<EventState>;
   delete: (s: EventState) => Promise<EventState>;
+  openLink: (s: EventState, arg?: unknown) => Promise<EventState>;
 }>("himiOwnerLiteEvent", {
   state: shape({ status: "loading" }),
   actions: {
@@ -208,7 +243,9 @@ const svc = defineService<EventState, {
         return shape({ ...s, status: "error", error: "Sample item not found." });
       }
       try {
-        return await refresh(shape({ ...s, id, status: "loading" }), id);
+        const loaded = await refresh(shape({ ...s, id, status: "loading" }), id);
+        await cacheBodyText(loaded);
+        return loaded;
       } catch (e) {
         // Offline: fall back to the last-synced local row before the demo/error paths.
         const cached = await cacheGet(id);
@@ -229,7 +266,9 @@ const svc = defineService<EventState, {
         return shape({ ...s, status: "error", error: "Sample item not found." });
       }
       try {
-        return await refresh(shape({ ...s, status: "loading" }), s.id);
+        const loaded = await refresh(shape({ ...s, status: "loading" }), s.id);
+        await cacheBodyText(loaded);
+        return loaded;
       } catch (e) {
         const cached = await cacheGet(s.id);
         if (cached) return cachedDetail(s, cached);
@@ -256,6 +295,11 @@ const svc = defineService<EventState, {
         return shape({ ...s, actionMessage: ownerLoadError(e) });
       }
     },
+    // [rico] #3499 — a link tapped in the RichContent description.
+    openLink: async (s, arg) => shape({
+      ...s,
+      actionMessage: (await openRichLink(arg)) ? "" : copyParam("ownerEvent.linkOpenFailed", "This link could not be opened."),
+    }),
   },
 });
 

package/templates/events-meetups/dev/index.ts

@@ -2142,7 +2142,7 @@ const SCREENS = runtimeSetting({
             "verticals": "[\"feed\",\"events\",\"blog\",\"groups\"]",
             "homeModules": "[{\"id\":\"saved\",\"label\":\"Saved on this device\",\"dataSource\":\"device.saved_items\",\"emptyWhen\":[\"noSavedContent\"]},{\"id\":\"section_0\",\"label\":\"Next up\",\"dataSource\":\"eventsFirst.section0\",\"emptyWhen\":[\"noNextEvent\"]},{\"id\":\"section_1\",\"label\":\"This season\",\"dataSource\":\"eventsFirst.section1\",\"emptyWhen\":[\"noUpcomingEvents\"]},{\"id\":\"section_2\",\"label\":\"Discover 3\",\"dataSource\":\"eventsFirst.section2\"},{\"id\":\"section_3\",\"label\":\"Latest from the community\",\"dataSource\":\"eventsFirst.section3\"}]",
             "ownerDefaultLayout": "eventsFirst",
-            "copy": "{\"home.activityTitle\":\"Latest from the community\",\"home.agendaTitle\":\"This season\",\"home.allEventsCta\":\"All events\",\"home.eventsTitle\":\"Upcoming events\",\"home.groupsSubtitle\":\"Find your crew.\",\"home.groupsTitle\":\"Groups\",\"home.membersCaption\":\"Who's coming\",\"home.nextUpCaption\":\"Next up\",\"home.onboardingBody\":\"See what's next, RSVP in a couple of taps, and keep up with the community between events — all in one place.\",\"home.recapsCaption\":\"Event recaps\",\"home.rsvpCta\":\"View event & RSVP\"}"
+            "copy": "{\"home.activityTitle\":\"Latest from the community\",\"home.agendaTitle\":\"This season\",\"home.allEventsCta\":\"All events\",\"home.eventsTitle\":\"Upcoming events\",\"home.groupsSubtitle\":\"Find your crew.\",\"home.groupsTitle\":\"Groups\",\"home.membersCaption\":\"Who's coming\",\"home.nextUpCaption\":\"Next up\",\"home.onboardingBody\":\"See what's next, RSVP in a couple of taps, and keep up with the community between events — all in one place.\",\"home.profileBody\":\"Sign in for RSVPs, groups and saved posts.\",\"home.recapsCaption\":\"Event recaps\",\"home.rsvpCta\":\"View event & RSVP\"}"
           }
         }
       }
@@ -2193,7 +2193,7 @@ const SCREENS = runtimeSetting({
                 "package": "himalaya",
                 "type": "Text",
                 "props": {
-                  "text": "Orders, bookings, RSVPs and saved content in one place.",
+                  "text": "RSVPs, groups and saved content in one place.",
                   "style": "body",
                   "color": "textSecondary"
                 }
@@ -3329,7 +3329,10 @@ const SCREENS = runtimeSetting({
           "bottom": 28
         },
         "onAppear": {
-          "actionId": "tier5.himiStoreAccount.refresh"
+          "actionId": "tier5.himiStoreAccount.refresh",
+          "params": {
+            "copy": "{\"account.subtitle\":\"RSVPs, groups and saved content in one place.\",\"storeAccount.authBody\":\"Sign in to continue — RSVPs and groups stay with you.\",\"storeAccount.authBodyRegister\":\"Create a member account to continue — RSVPs and groups stay with you.\"}"
+          }
         }
       }
     },

package/templates/events-meetups-owner/dev/index.ts

@@ -68631,6 +68631,48 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
                         }
                       }
                     },
+                    {
+                      "id": "event_body",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "RichContent",
+                        "props": {
+                          "documentJsonPath": "$service:himiOwnerLiteEvent.bodyJson",
+                          "onLink": {
+                            "actionId": "tier5.himiOwnerLiteEvent.openLink"
+                          },
+                          "fallback": {
+                            "id": "",
+                            "body": {
+                              "package": "himalaya",
+                              "type": "Text",
+                              "props": {
+                                "text": "$service:himiOwnerLiteEvent.bodyText",
+                                "style": "body",
+                                "color": "textPrimary",
+                                "collapseWhenEmpty": true
+                              }
+                            }
+                          }
+                        }
+                      }
+                    },
+                    {
+                      "id": "event_body_text",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Text",
+                        "props": {
+                          "text": "$service:himiOwnerLiteEvent.bodyText",
+                          "style": "body",
+                          "color": "textPrimary",
+                          "collapseWhenEmpty": true
+                        }
+                      },
+                      "modifiers": {
+                        "hiddenPath": "$service:himiOwnerLiteEvent.hasBodyJson"
+                      }
+                    },
                     {
                       "id": "event_info_card",
                       "body": {
@@ -68969,7 +69011,8 @@ const TEMPLATED: { pattern: string; display: string; liveSeed?: LiveSeed; static
       "contentType": "application/javascript+ts-bundle",
       "declaredCapabilities": [
         "wix_api",
-        "local_database"
+        "local_database",
+        "open_url"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"