@wix/himalaya-cli 0.1582.0 → 0.1584.0

package/templates/gym-fitness/himalaya.content.json

@@ -70,6 +70,9 @@
     "himi_my_subscriptions": {
       "displayName": "My Subscriptions"
     },
+    "himi_notif_settings": {
+      "displayName": "Notif Settings"
+    },
     "himi_order": {
       "displayName": "Order"
     },

package/templates/gym-fitness/tier5-src/_shared/booking-location.ts

@@ -0,0 +1,147 @@
+// The member's chosen booking location, shared by the Services, Agenda and Choose Time
+// screens (Branded Lite bookings). Each screen has its own worker, so the choice lives in the
+// on-device store: one `booking_prefs` row, read when a screen loads and written when the member
+// picks a location. A bundle in an app that has not granted `local_database` (or has no
+// `booking_prefs` entity) falls back to "All locations" on every screen — every call is wrapped.
+//
+// Keys: a business location's id (the same id a Wix availability slot carries in
+// `location.id`), else "name|address" for a location with no id. "" is "All locations".
+
+import { get, upsert, type DbEntity } from "@himalaya/local-db";
+import { copyParam, copyTemplate } from "./himi-copy.js";
+
+export const BOOKING_PREFS_ENTITY = "booking_prefs";
+const LOCATION_ROW = "location";
+
+/** The shared choice: a location key ("" = every location) and the label it was chosen under. */
+export interface SharedLocation { id: string; label: string }
+
+export const ALL_LOCATIONS: SharedLocation = { id: "", label: "" };
+
+/** How long a screen's load waits for the store before it shows every location. */
+const READ_TIMEOUT_MS = 800;
+
+/** `promise`, or a rejection after `ms` where the host has a timer: a store call the native bridge
+ *  never answers must not hang a screen's load. Timer-less hosts get the raw promise. */
+function bounded<T>(promise: Promise<T>, ms: number): Promise<T> {
+  const host = globalThis as { setTimeout?: (fn: () => void, ms: number) => unknown; clearTimeout?: (timer: unknown) => void };
+  if (typeof host.setTimeout !== "function") return promise;
+  return new Promise<T>((resolve, reject) => {
+    const timer = host.setTimeout!(() => reject(new Error(`timed out after ${ms}ms`)), ms);
+    promise.then(
+      (v) => { try { host.clearTimeout?.(timer); } catch { /* best-effort */ } resolve(v); },
+      (e) => { try { host.clearTimeout?.(timer); } catch { /* best-effort */ } reject(e); },
+    );
+  });
+}
+
+/** The shared choice, or `undefined` when the store could not answer (no capability, no entity, a
+ *  bridge that never replied) — distinct from a stored "All locations", so a screen can keep its own
+ *  choice when the shared one is unknown rather than reset it. */
+export async function readSharedLocationResult(): Promise<SharedLocation | undefined> {
+  try {
+    const row = (await bounded(get(BOOKING_PREFS_ENTITY, LOCATION_ROW), READ_TIMEOUT_MS)) as { locationId?: unknown; locationLabel?: unknown } | null;
+    const id = typeof row?.locationId === "string" ? row.locationId : "";
+    const label = typeof row?.locationLabel === "string" ? row.locationLabel : "";
+    return { id, label };
+  } catch (err) {
+    console.warn("booking_prefs: the shared location could not be read", err);
+    return undefined;
+  }
+}
+
+/** The shared choice, "All locations" when it cannot be read. */
+export async function readSharedLocation(): Promise<SharedLocation> {
+  return (await readSharedLocationResult()) ?? ALL_LOCATIONS;
+}
+
+export async function writeSharedLocation(location: SharedLocation): Promise<void> {
+  try {
+    // Bounded like the read: a bridge that never answers must not hold a screen's action open.
+    await bounded(upsert(BOOKING_PREFS_ENTITY, { id: LOCATION_ROW, locationId: location.id, locationLabel: location.label } as DbEntity), READ_TIMEOUT_MS);
+  } catch { /* capability not granted: the choice stays on this screen */ }
+}
+
+/** One location a screen can filter by. */
+export interface LocationChoice { key: string; label: string; sub: string }
+
+type WixLocationLike = { id?: unknown; name?: unknown; formattedAddress?: unknown; address?: unknown; locationType?: unknown };
+
+/** A Wix location (a slot's `location`, or a service location's `business` / `custom` part) as a
+ *  choice. A location with neither a name nor an address has no key: it is not offered.
+ *
+ *  The key is what every bookings screen compares by, so it must come out the same from a service
+ *  location and from a slot at it: a BUSINESS location by its id (a slot carries that id); any other
+ *  place by its address, or its name when it has none — a custom place's slot carries no id, so the
+ *  service's custom id would match none of its sessions. `business` defaults to the slot's own
+ *  `locationType`. */
+export function locationChoice(loc: WixLocationLike | undefined, business?: boolean): LocationChoice {
+  const name = typeof loc?.name === "string" ? loc.name.trim() : "";
+  const rawAddress = loc?.formattedAddress ?? (loc?.address as { formattedAddress?: unknown } | undefined)?.formattedAddress;
+  const address = typeof rawAddress === "string" ? rawAddress.trim() : "";
+  const id = typeof loc?.id === "string" ? loc.id : "";
+  if (!name && !address) return { key: "", label: "", sub: "" };
+  const isBusiness = business ?? (loc?.locationType === "OWNER_BUSINESS" || loc?.locationType === "BUSINESS");
+  const key = isBusiness && id ? id : address ? `addr:${address.toLowerCase()}` : `name:${name.toLowerCase()}`;
+  return { key, label: name || address, sub: name && address ? address : "" };
+}
+
+/** The keys of a Wix service's own locations (business and custom), in the service's order. */
+export function serviceLocationChoices(locations: unknown): LocationChoice[] {
+  if (!Array.isArray(locations)) return [];
+  const out: LocationChoice[] = [];
+  for (const raw of locations) {
+    const l = (raw ?? {}) as { type?: unknown; business?: Record<string, unknown>; custom?: Record<string, unknown>; calculatedAddress?: Record<string, unknown> };
+    const business = l.type === "BUSINESS" || !!l.business;
+    const part = business ? l.business : l.custom;
+    const choice = locationChoice(part ? { ...part, address: part.address ?? l.calculatedAddress } : undefined, business);
+    if (choice.key && !out.some((c) => c.key === choice.key)) out.push(choice);
+  }
+  return out;
+}
+
+/** Distinct choices in first-seen order. */
+export function distinctChoices(choices: Iterable<LocationChoice>): LocationChoice[] {
+  const out: LocationChoice[] = [];
+  for (const c of choices) if (c.key && !out.some((o) => o.key === c.key)) out.push(c);
+  return out;
+}
+
+/** A row of the location sheet ("All locations" first). `id` "" is "All locations". */
+export interface LocationOptionRow {
+  id: string; label: string; sub: string; hasSub: boolean; noSub: boolean;
+  selected: boolean; notSelected: boolean; a11y: string;
+}
+
+/** The location menu's bound fields for a screen offering `choices` with `selectedKey` chosen.
+ *  Two or more choices show the menu; a selected key that is no longer offered reads as
+ *  "All locations" (the caller filters nothing for it either — see `effectiveLocation`). */
+export function locationMenu(choices: LocationChoice[], selectedKey: string): {
+  locationOptions: LocationOptionRow[]; locationLabel: string; locationA11y: string;
+  hasLocationMenu: boolean; noLocationMenu: boolean; locationActive: boolean; noLocationActive: boolean;
+} {
+  // bookingCommon.*: every bookings screen forwards that prefix, so a copy pack reaches each picker.
+  const all = copyParam("bookingCommon.allLocations", "All locations");
+  const key = effectiveLocation(choices, selectedKey);
+  const label = key ? (choices.find((c) => c.key === key)?.label ?? all) : all;
+  const menu = choices.length >= 2;
+  return {
+    locationOptions: menu ? [{ key: "", label: all, sub: "" }, ...choices].map((c) => {
+      const selected = c.key === key;
+      return { id: c.key, label: c.label, sub: c.sub, hasSub: !!c.sub, noSub: !c.sub, selected, notSelected: !selected,
+        a11y: [c.label, c.sub, selected ? copyParam("bookingCommon.selected", "Selected") : ""].filter(Boolean).join(", ") };
+    }) : [],
+    locationLabel: label,
+    locationA11y: copyTemplate("bookingCommon.locationLabel", "Location, {label}", { label }),
+    hasLocationMenu: menu,
+    noLocationMenu: !menu,
+    locationActive: menu && !!key,
+    noLocationActive: !(menu && !!key),
+  };
+}
+
+/** The key a screen filters by: the chosen one while the screen offers it (and offers a choice
+ *  at all), else "" — a location from another screen this one does not have filters nothing. */
+export function effectiveLocation(choices: LocationChoice[], selectedKey: string): string {
+  return selectedKey && choices.length >= 2 && choices.some((c) => c.key === selectedKey) ? selectedKey : "";
+}

package/templates/gym-fitness/tier5-src/_shared/booking-session.ts

@@ -0,0 +1,222 @@
+// One bookable session of a CLASS or COURSE service, and the member's place in it — shared by the
+// Agenda (one row per session) and the service screen opened from an Agenda row, so the two show the
+// same state and offer the same control for the same session.
+import { addDays, dayKey } from "@himalaya/time";
+import { listWaitlists, queryBookings, type WixAvailabilityEntry, type WixBooking, type WixService } from "@himalaya/wix-bookings";
+import { copyParam, copyTemplate } from "./himi-copy.js";
+import { slotStartInstant } from "./himi-bookings.js";
+import { formatServicePrice } from "./wix-service-price.js";
+import { assertMemberAccess, memberAccess, type MemberAccess } from "./member-access.js";
+import { locationChoice } from "./booking-location.js";
+
+/** A booking in one of these no longer holds a place. */
+const RELEASED = new Set(["CANCELED", "CANCELLED", "DECLINED"]);
+
+export type Place = "booked" | "waitlisted" | "";
+
+/** One session as the screen needs it. `key` is the row's identity: the Wix session id when the
+ *  entry has one — two sessions of a class at the same time are two rows — else service + start. */
+export interface Session {
+  key: string;
+  /** The Wix session id — what a waitlist registers against. "" when the entry has none. */
+  sessionId: string;
+  serviceId: string;
+  /** A class session is booked on its own; a course session belongs to a course booked whole. */
+  kind: "class" | "course";
+  title: string;
+  /** The service's fixed price ("₪60"), "" when it has none to show (varied, custom, free). */
+  price: string;
+  start: string; // ISO instant with offset
+  end: string;
+  day: string; // LOCAL day key
+  staff: string;
+  location: string;
+  /** The location as a filter choice (`booking-location.ts`): key "" when it has no name or address. */
+  locationKey: string;
+  locationSub: string;
+  total: number;
+  open: number;
+  bookable: boolean;
+  /** The session's waitlist: its size (0 = it has none) and the places left on it. */
+  waitlistTotal: number;
+  /** A booking policy closes it (too early, too late, online booking off): no Book, no Waitlist. */
+  policyClosed: boolean;
+  /** The ONLY policy reason is that booking has not opened yet ("Not open yet", not "Closed"). */
+  tooEarly: boolean;
+  waitlistOpen: number;
+}
+
+export interface MemberPlace { bookingId: string; revision: string; place: Place; registrationId?: string; confirmed?: boolean }
+
+const count = (v: unknown): number => {
+  const n = Number(v ?? 0);
+  return Number.isFinite(n) && n > 0 ? n : 0;
+};
+
+/** A slot's instant as an ISO string WITH an offset — iOS parses wire dates strictly. */
+function instantIso(slot: { startDate?: string; timezone?: unknown }, field: "startDate" | "endDate"): string {
+  const ms = slotStartInstant({ startDate: (slot as Record<string, unknown>)[field] as string | undefined, timezone: slot.timezone });
+  return Number.isFinite(ms) ? new Date(ms).toISOString() : "";
+}
+
+export const sessionKey = (serviceId: string, startIso: string): string => `${serviceId}|${Date.parse(startIso)}`;
+
+/** A raw availability entry → a Session, or null when it has no usable start. */
+export function sessionOf(entry: WixAvailabilityEntry, service: WixService): Session | null {
+  const slot = (entry.slot ?? {}) as Record<string, unknown> & { startDate?: string; endDate?: string; timezone?: unknown };
+  const start = instantIso(slot, "startDate");
+  if (!start) return null;
+  const end = instantIso(slot, "endDate") || start;
+  const raw = entry as unknown as {
+    totalSpots?: number; openSpots?: number; waitingList?: { totalSpots?: number; openSpots?: number };
+    bookingPolicyViolations?: { tooEarlyToBook?: boolean; tooLateToBook?: boolean; bookOnlineDisabled?: boolean; validSubmissionRequired?: boolean };
+  };
+  const policy = raw.bookingPolicyViolations;
+  const tooLate = policy?.tooLateToBook === true, offline = policy?.bookOnlineDisabled === true;
+  const tooEarly = policy?.tooEarlyToBook === true;
+  // A session that also needs a form submitted is not just "not open yet": it never opens for the app.
+  const needsForm = policy?.validSubmissionRequired === true;
+  const resource = slot.resource as { name?: string } | undefined;
+  const location = slot.location as { id?: string; name?: string; formattedAddress?: string } | undefined;
+  const choice = locationChoice(location);
+  const serviceId = String(slot.serviceId ?? service.id ?? "");
+  const sessionId = typeof slot.sessionId === "string" ? slot.sessionId : "";
+  return {
+    key: sessionId || sessionKey(serviceId, start),
+    sessionId,
+    serviceId,
+    kind: ((service as WixService & { type?: string }).type ?? "").toUpperCase() === "COURSE" ? "course" : "class",
+    title: service.name ?? "",
+    price: formatServicePrice(service),
+    start, end,
+    day: dayKey(start),
+    staff: resource?.name?.trim() ?? "",
+    location: (location?.name || location?.formattedAddress || "").trim(),
+    locationKey: choice.key,
+    locationSub: choice.sub,
+    total: count(raw.totalSpots),
+    open: count(raw.openSpots),
+    bookable: entry.bookable !== false,
+    waitlistTotal: count(raw.waitingList?.totalSpots),
+    waitlistOpen: count(raw.waitingList?.openSpots),
+    policyClosed: tooEarly || tooLate || offline || needsForm,
+    tooEarly: tooEarly && !tooLate && !offline && !needsForm,
+  };
+}
+
+/** The member's bookings in the window → their place, keyed by the booking's session id when it
+ *  names one, else by service + start. `bySession` turns that into each row's own key. */
+export function placesOf(bookings: WixBooking[], email: string): Map<string, MemberPlace> {
+  const out = new Map<string, MemberPlace>();
+  for (const b of bookings) {
+    if (!b.id || b.contactDetails?.email?.trim().toLowerCase() !== email) continue;
+    const status = (b.status || "").toUpperCase();
+    if (RELEASED.has(status)) continue;
+    const slot = b.bookedEntity?.slot;
+    const serviceId = slot?.serviceId ?? "";
+    const start = b.startDate || (slot ? instantIso(slot, "startDate") : "");
+    if (!serviceId || !start) continue;
+    // Its session when the booking names one, so a parallel session is not marked too.
+    const bookedSession = (slot as { sessionId?: unknown } | undefined)?.sessionId;
+    out.set(typeof bookedSession === "string" && bookedSession ? bookedSession : sessionKey(serviceId, start), {
+      bookingId: b.id,
+      revision: String((b as WixBooking & { revision?: string | number }).revision ?? ""),
+      place: status === "WAITING_LIST" ? "waitlisted" : "booked",
+      confirmed: status === "CONFIRMED",
+    });
+  }
+  return out;
+}
+
+/** Each session's place, under the session's own key: by its session id, else by service + start. */
+export function bySession(found: Map<string, MemberPlace>, inWindow: Session[]): Map<string, MemberPlace> {
+  const out = new Map<string, MemberPlace>();
+  for (const x of inWindow) {
+    const place = (x.sessionId ? found.get(x.sessionId) : undefined) ?? found.get(sessionKey(x.serviceId, x.start));
+    if (place) out.set(x.key, place);
+  }
+  return out;
+}
+
+/** "4 spots left", "1 spot left", or "Full". Empty when the site reports no capacity, and for a
+ *  course: a session's open spots do not say whether the course has room. */
+export function spotsLabel(s: Session): string {
+  if (s.kind === "course" || s.total <= 0) return "";
+  if (s.open <= 0) return copyParam("agenda.full", "Full");
+  return s.open === 1 ? copyParam("agenda.spotLeft", "1 spot left") : copyTemplate("agenda.spotsLeft", "{n} spots left", { n: s.open });
+}
+
+/** The one control a session offers the member, as the Agenda row shows it. */
+export type SessionControl = "book" | "waitlist" | "course" | "booked" | "waitlisted" | "closed";
+
+/** Which control `s` offers to a member holding `place`, and — for "closed" — why ("Full",
+ *  "Not open yet", "Closed"). A course is booked whole on its service screen: "course". */
+export function sessionControl(s: Session, place: MemberPlace | undefined): { control: SessionControl; closedLabel: string; full: boolean } {
+  const mine = place?.place ?? "";
+  const course = s.kind === "course";
+  const full = s.total > 0 && s.open <= 0;
+  const closedLabel = full ? copyParam("agenda.full", "Full")
+    : s.tooEarly ? copyParam("agenda.notOpenYet", "Not open yet") : copyParam("agenda.closed", "Closed");
+  if (mine === "booked") return { control: "booked", closedLabel, full };
+  if (mine === "waitlisted") return { control: "waitlisted", closedLabel, full };
+  if (course) return { control: "course", closedLabel, full };
+  if (s.bookable && !full && !s.policyClosed) return { control: "book", closedLabel, full };
+  // Availability is capacity AND policy: a full session the policy closes is not joinable either.
+  if (full && s.waitlistOpen > 0 && !!s.sessionId && !s.policyClosed) return { control: "waitlist", closedLabel, full };
+  return { control: "closed", closedLabel, full };
+}
+
+/** Mark the places that are WAITLIST registrations, with the registration id leaving needs.
+ *  A registration's booking is an ordinary pending booking, so the booking alone cannot say
+ *  "on the waitlist" — only the session's waitlist can, and only sessions with one are asked. */
+export function markWaitlisted(found: Map<string, MemberPlace>, sessionsByKey: Map<string, Session>, lists: { waitingResource?: string; registrations?: { id?: string; bookingId?: string }[] }[]): void {
+  const byBooking = new Map<string, string>();
+  for (const list of lists) for (const r of list.registrations ?? []) if (r.bookingId && r.id) byBooking.set(r.bookingId, r.id);
+  for (const [key, place] of found) {
+    const registrationId = byBooking.get(place.bookingId);
+    if (registrationId && sessionsByKey.has(key)) found.set(key, { ...place, place: "waitlisted", registrationId });
+  }
+}
+
+/** The signed-in member's bookings in the window, with the member they were read for: the two
+ *  are committed together, so a write checks against the member its place belongs to. A visitor
+ *  has none; a read that fails fails the load. */
+export async function placesIn(start: string, end: string, inWindow: Session[], attempt = 0): Promise<{ who: MemberAccess | undefined; found: Map<string, MemberPlace> }> {
+  const who = await memberAccess().catch(() => undefined);
+  if (!who?.email) return { who, found: new Map() };
+  try {
+    const from = new Date(`${start}T00:00:00`).toISOString();
+    const to = new Date(`${dayKey(addDays(end, 1))}T00:00:00`).toISOString();
+    // Every page, not the first 100: a booking past it would read Book again. Bounded.
+    const bookings: WixBooking[] = [];
+    for (let page = 0; page < 5; page++) {
+      const res = await queryBookings({ query: { filter: { "contactDetails.email": { $eq: who.email }, startDate: { $gte: from, $lt: to } }, paging: { limit: 100, offset: page * 100 } } } as never);
+      const batch = res.bookings ?? [];
+      bookings.push(...batch);
+      if (batch.length < 100) break;
+    }
+    // The same member still? A sign-out or a switch during the read must not paint one member's
+    // bookings for another (the shared member-bookings read checks the same way).
+    await assertMemberAccess(who);
+    const found = bySession(placesOf(bookings, who.email), inWindow);
+    const byKey = new Map(inWindow.map((x) => [x.key, x] as const));
+    const waitlisted = [...found.keys()].map((k) => byKey.get(k)).filter((x): x is Session => !!x && x.waitlistTotal > 0 && !!x.sessionId);
+    if (waitlisted.length) {
+      // Only the session's waitlist can tell a waitlist place from a pending booking. If it cannot
+      // be read, that place is neither Booked nor free: the load fails (error state, Retry) rather
+      // than offer Book or Waitlist on a session the member already holds.
+      markWaitlisted(found, byKey, (await listWaitlists(waitlisted.map((x) => x.sessionId))).list ?? []);
+      // The lookup awaited too: still the same member?
+      await assertMemberAccess(who);
+    }
+    return { who, found };
+  } catch (err) {
+    // A failed read is not "no bookings": showing Book on a session the member holds invites a
+    // duplicate. It fails the load (the error state, with Retry), as My Bookings does.
+    if ((err as { name?: string } | null)?.name !== "MemberAccessChanged") throw err;
+    // A sign-out or a switch during the read: read again, for whoever is signed in now — never
+    // commit them with places nobody read for them. A second switch fails the load.
+    if (attempt < 1) return placesIn(start, end, inWindow, attempt + 1);
+    throw err;
+  }
+}

package/templates/gym-fitness/tier5-src/_shared/branded-lite-hosted.ts

@@ -97,6 +97,7 @@ export const HOSTED_SCREEN_VERTICALS: Readonly<Record<string, readonly BrandedLi
   himi_gift_card: ["giftCards"],
   himi_gift_cards: ["giftCards"],
   himi_groups: ["groups"],
+  himi_group_about: ["groups"],
   himi_invoice: ["invoices"],
   himi_invoices: ["invoices"],
   himi_loyalty: ["loyalty"],
@@ -107,7 +108,6 @@ export const HOSTED_SCREEN_VERTICALS: Readonly<Record<string, readonly BrandedLi
   himi_my_events: ["events"],
   himi_my_subscriptions: ["plans"],
   himi_new_message: ["inbox", "members"],
-  himi_notif_settings: ["notifsettings"],
   himi_notifications: ["notifications"],
   himi_orders: ["store"],
   himi_photo_album: ["galleries"],

package/templates/gym-fitness/tier5-src/_shared/collection-contract.ts

@@ -19,6 +19,8 @@ export interface CollectionConfig {
   /** Numeric 0–5 row field rendered as a Rating (accessible "N out of 5") instead of
    *  folding a "★★★★☆" glyph string into the metadata line, so screen readers get a value. */
   rating?: string;
+  /** Domain-provided calendar text and its unavailable flag, kept separate from media. */
+  dateBadge?: { text: string; hidden: string };
   sectioned?: boolean;
   view: 'list' | 'grid';
   backendQuery?: boolean;
@@ -38,7 +40,13 @@ export interface CollectionConfig {
   /** The card's primary verb, shown as a visible button beside the overflow.
    * `screenId` opens that screen with the row id; without it the verb reuses the
    * row's own tap action (the detail screen that owns the verb). */
-  primaryVerb?: { label: string; screenId?: string };
+  primaryVerb?: { label: string; screenId?: string;
+    /** A row field holding THIS row's verb label (Register, RSVP, Buy Tickets…); `label` stays the fallback copy. */
+    labelPath?: string;
+    /** A row boolean that hides the verb on rows that offer no action (an event with no registration). */
+    hiddenPath?: string };
+  /** The worker action that shares a row (`tier5.<service>.<name>` with `{ id }`): adds Share to the card's overflow menu. */
+  shareAction?: string;
   /** A TIME-BOUND entity (an event, a booking, a reservation): the boolean row field the
    *  DOMAIN sets once the record has finished — computed by the same rule as the row's own
    *  "Past" label, in the same place, so the two cannot disagree. A finished
@@ -73,7 +81,7 @@ export const COLLECTIONS: Record<string, CollectionConfig> = {
   himiBookingBookings: { rows: 'rows', title: 'title', subtitle: 'subtitle', metadata: ['status'], view: 'list', backendQuery: true,
     defaultFilter: 'value:Upcoming', searchPlaceholder: 'Search by booking ID', countNoun: ['booking', 'bookings'], filterValues: ['Upcoming', 'Past', 'Cancelled'],
     sortLabels: { default: 'Soonest', az: 'Oldest', za: 'Latest' } },
-  himiEvents: { rows: 'results', title: 'title', subtitle: 'dateLine', image: 'image', view: 'grid', backendQuery: true, defaultFilter: 'value:Upcoming', searchPlaceholder: 'Search events', countNoun: ['event', 'events'], filterValues: ['Upcoming', 'Past'], sortLabels: { default: 'Date', az: 'Title A–Z', za: 'Title Z–A' }, primaryVerb: { label: 'Register' }, endedWhen: 'isPast' },
+  himiEvents: { rows: 'results', title: 'title', subtitle: 'dateLine', image: 'image', dateBadge: { text: 'dateBadge', hidden: 'noDateBadge' }, gridColumns: 1, view: 'grid', backendQuery: true, defaultFilter: 'value:Upcoming', searchPlaceholder: 'Search events', countNoun: ['event', 'events'], filterValues: ['Upcoming', 'Past'], sortLabels: { default: 'Date', az: 'Title A–Z', za: 'Title Z–A' }, primaryVerb: { label: 'Register', labelPath: 'actionLabel', hiddenPath: 'noAction' }, shareAction: 'share', endedWhen: 'isPast' },
   himiBlogFeed: { rows: 'posts', title: 'title', subtitle: 'excerpt', image: 'image', filter: 'category', filterValuesFrom: 'categories', view: 'grid', narrowedBy: 'selectedCategoryId' },
   himiOwnerLiteProducts: { rows: 'products', title: 'name', subtitle: 'price', image: 'image', view: 'grid', backendQuery: true, countNoun: ['product', 'products'] },
   himiOwnerModules: { instanceInput: 'module', rows: 'rows', title: 'title', subtitle: 'subtitle', image: 'image', filter: 'statusLabel', view: 'list', paged: true, reviewAction: 'prepareRecord', reviewSelectedAction: 'prepareSelected' },
@@ -208,7 +216,15 @@ export function projectCollection(source: CollectionRow[], config: CollectionCon
       ...(config.endedWhen ? (() => {
         const ended = row[config.endedWhen] === true || (config.endedWhen === 'isPast' && row.statusLabel === 'Past');
         return { collectionEnded: ended, collectionNotEnded: !ended };
-      })() : {}) })),
+      })() : {}),
+      // A row restored from state saved by an older build has no badge flag. An unset hidden flag
+      // fails open and would paint an empty chip, so it reads as "no badge" until a refresh.
+      ...(config.dateBadge && typeof row[config.dateBadge.hidden] !== 'boolean'
+        ? { [config.dateBadge.text]: '', [config.dateBadge.hidden]: true } : {}),
+      // Same for a per-row verb: an unset hidden flag fails open and would show a verb with an unresolved
+      // label, so a row without the flag offers no action until a refresh establishes one.
+      ...(config.primaryVerb?.hiddenPath && typeof row[config.primaryVerb.hiddenPath] !== 'boolean'
+        ? { ...(config.primaryVerb.labelPath ? { [config.primaryVerb.labelPath]: '' } : {}), [config.primaryVerb.hiddenPath]: true } : {}) })),
     filters, loaded: rows.length,
   };
 }

package/templates/gym-fitness/tier5-src/_shared/event-registration.ts

@@ -0,0 +1,86 @@
+// Pure Events registration helpers shared by the event detail and the event list: which action an
+// event offers, its label, and the URLs behind it. One copy, so a card and the detail screen never
+// disagree about whether an event can be registered for.
+import type { WixEvent } from "@himalaya/wix-events";
+import { formatWeekdayDateTime } from "./engine-intl.js";
+import { copyParam } from "./himi-copy.js";
+
+function detailCopy(key: string, fallback: string): string { return copyParam(key, fallback); }
+
+/** Registration CTA kind derived from the event's registration/eventType. */
+export type RegistrationKind = "rsvp" | "tickets" | "external" | "none";
+
+/** Map registration status and decoded eventType onto the CTA variant. The decoded
+ *  `eventType` already folds registration.type / registration.initialType /
+ *  the legacy flat `type` (decodeEvent, #478). Without a recognized type or
+ *  status there is no registration action to offer. */
+export function registrationKindOf(e: WixEvent): RegistrationKind {
+  const raw = e as unknown as { registration?: { type?: string; initialType?: string; status?: string } };
+  const value = (raw.registration?.type ?? e.eventType ?? raw.registration?.initialType ?? "").toUpperCase();
+  if (value === "NONE" || value.includes("NO_REGISTRATION")) return "none";
+  // Open statuses select the footer action, so they must also select the
+  // inventory read and action guards when type metadata is absent or stale.
+  switch (raw.registration?.status?.toUpperCase()) {
+    case "OPEN_TICKETS": return "tickets";
+    case "OPEN_EXTERNAL": return "external";
+    case "OPEN_RSVP":
+    case "OPEN_RSVP_WAITLIST_ONLY":
+    case "SCHEDULED_RSVP": return "rsvp";
+  }
+  if (value.includes("EXTERNAL")) return "external";
+  if (value.includes("TICKET")) return "tickets";
+  if (value.includes("RSVP")) return "rsvp";
+  return "none";
+}
+
+export function eventStatus(e: WixEvent): string {
+  const raw = e as unknown as { status?: string };
+  return (raw.status ?? e.eventStatus ?? "").toUpperCase();
+}
+
+export function registrationUi(e: WixEvent, now: number): { state: string; label: string; action: string; caption: string; notice: string } {
+  const raw = e as unknown as { registration?: { status?: string; registrationPaused?: boolean; registrationDisabled?: boolean; allowedGuestTypes?: string; rsvp?: { startDate?: string }; tickets?: { soldOut?: boolean }; external?: { url?: string } }; form?: { messages?: { registrationClosed?: { message?: string; exploreEventsActionLabel?: string }; ticketsUnavailable?: { message?: string; exploreEventsActionLabel?: string } } } };
+  const r = raw.registration ?? {};
+  const status = eventStatus(e);
+  const type = registrationKindOf(e);
+  if (status === "CANCELED") return { state: "notice", label: "", action: "", caption: "", notice: detailCopy("event.canceledNotice", "This event was canceled.") };
+  if (status === "ENDED") return { state: "notice", label: "", action: "", caption: "", notice: detailCopy("event.endedNotice", "This event has ended.") };
+  if (type === "none" || r.registrationDisabled) return { state: "none", label: "", action: "", caption: "", notice: "" };
+  const ownerClosed = raw.form?.messages?.registrationClosed?.message;
+  const ownerSold = raw.form?.messages?.ticketsUnavailable?.message;
+  if (["CLOSED_AUTOMATICALLY", "CLOSED_MANUALLY"].includes(r.status || "") || r.registrationPaused) return { state: "notice", label: "", action: "", caption: "", notice: ownerClosed || detailCopy("event.closedNotice", "Registration is closed.") };
+  if (type === "tickets" && r.tickets?.soldOut) return { state: "notice", label: "", action: "", caption: "", notice: ownerSold || detailCopy("event.soldOutNotice", "Tickets are sold out.") };
+  if (r.status === "SCHEDULED_RSVP") return { state: "scheduled", label: detailCopy("event.rsvpCta", "RSVP"), action: "", caption: detailCopy("event.opensCaption", "RSVP opens {date}.").replace("{date}", r.rsvp?.startDate ? formatWeekdayDateTime(new Date(r.rsvp.startDate)) : ""), notice: "" };
+  if (r.status === "OPEN_RSVP_WAITLIST_ONLY") return { state: "waitlist", label: detailCopy("event.waitlistCta", "Join Waitlist"), action: "himi.open", caption: detailCopy("event.fullCaption", "This event is full."), notice: "" };
+  if (r.status === "OPEN_TICKETS" || type === "tickets") return { state: "tickets", label: detailCopy("event.ticketsCta", "Buy Tickets"), action: "openTickets", caption: "", notice: "" };
+  if (r.status === "OPEN_EXTERNAL" || type === "external") return registrationUrlOf(e)
+    ? { state: "external", label: detailCopy("event.externalCta", "Register"), action: "openRegistration", caption: "", notice: "" }
+    : { state: "none", label: "", action: "", caption: "", notice: "" };
+  if (type === "rsvp" && r.status === "OPEN_RSVP") return { state: "rsvp", label: detailCopy("event.rsvpCta", "RSVP"), action: "himi.open", caption: "", notice: "" };
+  if (r.status === "OPEN_RSVP" || (type === "rsvp" && !r.status)) return { state: "rsvp", label: detailCopy("event.rsvpCta", "RSVP"), action: "himi.open", caption: "", notice: "" };
+  void now;
+  return { state: "none", label: "", action: "", caption: "", notice: "" };
+}
+
+/** External registration URL / event page URL from the raw payload ("" when absent). */
+export function registrationUrlOf(e: WixEvent): string {
+  const raw = e as unknown as {
+    registration?: { external?: { registration?: string; url?: string } };
+    eventPageUrl?: { base?: string; path?: string } | string;
+  };
+  const external = raw.registration?.external?.registration ?? raw.registration?.external?.url;
+  if (typeof external === "string" && /^https?:\/\//i.test(external)) return external;
+  return eventPageUrlOf(e);
+}
+
+/** The event's public page URL when the payload carries one ("" otherwise). */
+export function eventPageUrlOf(e: WixEvent): string {
+  const raw = e as unknown as { eventPageUrl?: { base?: string; path?: string } | string };
+  const page = raw.eventPageUrl;
+  if (typeof page === "string" && /^https?:\/\//i.test(page)) return page;
+  if (page && typeof page === "object" && typeof page.base === "string" && page.base) {
+    const path = typeof page.path === "string" ? page.path : "";
+    return `${page.base.replace(/\/$/, "")}${path && !path.startsWith("/") ? "/" : ""}${path}`;
+  }
+  return "";
+}

package/templates/gym-fitness/tier5-src/_shared/himi-restaurants.ts

@@ -1,3 +1,4 @@
+import { descriptionBody } from "./rich-body.js";
 // Shared restaurants-menu shaping for himi workers (branded-lite `restaurants`
 // vertical): dish cards + menu categories derived from the Wix Restaurants
 // Menus hierarchy (menu → sections → items). Used by BOTH the menus worker
@@ -166,7 +167,7 @@ export function itemPriceVariants(item: WixItem): Array<{ id: string; variantId:
 
 /** HTML-stripped, whitespace-collapsed description snippet (≤ 90 chars). */
 export function descriptionSnippet(value: unknown, maxLength = 90): string {
-  const text = (typeof value === "string" ? value : "").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+  const text = descriptionBody(value).bodyText.replace(/\s+/g, " ").trim();
   return text.length > maxLength ? `${text.slice(0, maxLength - 1).trimEnd()}…` : text;
 }